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译 者 F 


作为 .NET 平台 最 重要 的 编程 语言 ，C# -一 经 问世 就 广 受 欢迎 。 其 设计 借鉴 了 CH. Java 和 Pascal 的 思想 ， 
吸收 了 各 种 有 效 的 编程 理念 和 技术 ， 如 泛 型 、LINQ、lambda 表达 式 等 ， 可 谓 博 采 众 长 。C# 不 仅 是 一 种 纯粹 的 
面向 对 象 语 言 ， 也 是 一 种 基于 组 件 的 语言 ， 支 持 属性 、 事 件 、 特 性 等 ， 功 能 强大 ， 又 十 分 灵活 。 直 到 今天 ， 依 
然 是 使 用 最 广泛 、 在 编程 语言 排行 榜 上 稳 居 前 列 的 语言 之 一 。 

每 个 新 版 本 的 C# 都 在 旧版 本 的 基础 上 进行 扩展 和 更 新 ，C# 7 也 是 如 此 ， 增 加 了 模式 匹配 、 元 组 、 局 部 函 
数 、 二 进 制 字面 量 等 。 选 择 C# 7 作为 入 门 语言 无 疑 是 正确 之 选 。C# 7 是 一 门 现代 语言 ， 有 助 于 你 从 一 开始 就 
形成 正确 的 编程 思维 。C# 提 供 大 量 高 级 功能 ， 变 得 非常 强大 ， 但 也 增加 了 学 习 难 度 。 好 在 ， 本 书 能 让 你 的 CH 
学 习 之 路 从 荆棘 密布 变 为 一 片 坦途 。 

本 书 是 学 习 C# 和 基础 知识 的 一 站 式 “ 充 电站 ” 浓墨重彩 地 描述 使 用 C# 7 和 Visual Studio 2017 编写 程序 的 基 
础 知识 ， 是 绝 佳 的 C# 入 门 书籍 。 本 书 全 面 透彻 地 讲解 CH, AR C#i 语 言 的 每 个 基本 部 分 ， 介 绍 C# 7 最 新 特性 。 
本 书 几 位 作者 具有 丰富 的 编程 经 验 ， 对 C# 语 言 的 理解 极其 深刻 。 即 使 是 初学 者 ， 也 可 在 本 书 的 指导 下 一 步 步 地 
掌握 C# 的 各 项 特性 。 而 具有 编程 经 验 ， 但 想 要 了 解 .NET 平台 的 读者 ， 也 会 从 本 书 受 益 。 

本 书 结构 合 理 ， 就 像 搭建 一 个 高 台 ， 首 先 打下 稳固 基础 ， 然 后 一 层 层 同上 人 鸡 砌 ; 每 一 章 都 以 前 面 的 内 容 为 
基础 ， 再 引入 一 些 新 内 容 ， 使 读者 对 C# 的 理解 越 来 越 全 面 、 深 刻 。 编 程 新 手 所 苦恼 的 ， 往 往 是 在 面 对 一 个 问题 
时 不 知 如 何 下 手 ， 而 完成 本 书 的 大 量 练习 后 ， 一 定 可 形成 用 编程 解决 问题 的 思维 方式 ， 也 可 触 类 旁 通 ， 解 决 从 
未 遇 到 的 问题 。 

对 于 这 本 经 典 之 作 ， 译 者 本 着 “ 诚 怪 诚 束 ”的 态度 ， 在 翻译 过 程 中 力求 “ 信 、 达 、 雅 ”， 但 鉴于 译 者 水 平 有 
限 ， 错 误 和 失误 在 所 难免 ， 如 有 任何 意见 和 建议 ， 请 不 音 指 正 。 感 激 不 尽 ! 本 书 全 部 章节 由 齐 立 博 翻译 ， 参 与 
EMERARA ER, RR Ei EEE ARR, EMG, BAW EW WFA, FBE, E 
Bi. EEE, WURAYÉ. WEER BRAE. RIE. X BRE AEA. KRA, BRIE DR., KI. 4L 

最 后 ， 希 望 读者 通过 阅读 本 书 能 早日 步 入 CHE R IER Se C# 语 言 之 美 ! 
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Benjamin Perkins(MBA、MCSD、ITID) 目 前 在 微软 (德国 桶 尼 黑 ) 工 作 ， 是 一 位 资深 的 高 级 工程 师 。 他 在 IT 
行业 工作 了 二 十 多 年 。 他 11 岁 时 就 开始 在 Atari 1200XL 台式 计算 机 上 用 QBasic 编写 计算 机 程序 。 他 喜爱 诊断 
和 排除 技术 问题 ， 品 味 写 出 好 程序 的 乐趣 。 高 中 毕业 后 ， 他 加 入 美国 军队 。 在 成 功 服 完 兵 役 后 ， 他 进入 得 克 萨 
斯 州 的 得 克 萨 斯 A&M 大 学 ， 在 那里 获得 管理 信息 系统 的 工商 管理 学 士 学 位 。 

他 在 IT 行业 的 足迹 遍及 整个 行业 ， 包 括 程 序 员 、 系 统 架 构 师 、 技 术 支 持 工 程 是 、 团 队 领 导 和 中 层 管理 。 在 
受 雇 于 惠普 时 ， 他 获得 了 诸多 奖项 、 学 位 和 证 书 。 他 对 技术 和 客户 服务 富有 激情 ， 期 待 排 除 故障 ， 编 写 出 更 多 
世界 级 技术 解决 方案 。 

“我 的 方法 是 烂熟 


于 心 之 后 才 编 写 代 码 ， 完 整 、 正 确 地 编写 一 次 ， 这 样 就 不 需要 再 次 考虑 它 ， 除 非 要 改 
Benjamin 与 妻子 Andrea 以 及 两 个 可 爱 的 孩子 Lea 和 Noa 一 起 快乐 地 生活 。 


Jacob Vibe Hammer 7571 X Systematic 公司 的 一 名 融 级 软件 工程 是， 帮助 医疗 行业 开发 解决 方案 。 目 他 刚 
能 拼写 单词 “BASIC” 之 时 ， 就 开始 了 目 己 的 编程 生涯 ，BASIC 也 是 他 使 用 的 第 一 门 编程 语言 。 从 那 以 后 ， 他 
Hit PPS RET a RR RR. {AEA 21 世纪 后 ， 他 主要 在 .NET 平台 上 工作 。 如 今 ， 他 主要 编写 CHA 
WPF 程序 ， 以 及 试用 NoSQL 数据 库 。Jacob 是 丹麦 人 ， 与 妻 儿 一 起 居住 在 丹麦 的 奥 胡 斯 市 。 

Jon D. Reid 担任 IFS Field Service Management(www.IFSWORLD.com) 的 产品 解决 方案 经 理 。 他 已 与 他 人 合 
4S ZARB. dh Beginning Visual C# 2015、Fast Track CH 和 Pro Visual Studio NET 等 。 
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John Mueller 是 一 位 日 由 撰 稳 人 和 技术 编辑 。 他 耗费 目 己 的 心血 编写 了 108 本 书 和 600 Zi CR. dun 
围 从 联网 到 人 工 入 能 ， 从 数据 库 党 理 到 编程 入 门 知识 ， 非 常 广 沁 。 由 他 执笔 的 目前 一 些 正在 发 行 的 图 书 涉及 用 
于 初学 者 的 Python、 用 于 数据 科学 家 的 Python 和 Amazon Web Services 等 主题 。 他 还 编写 了 一 些 有 关 复 法 和 机 
器 学 习 的 书籍 。 作 为 技术 编辑 ， 他 曾 帮 助 70 多 名 作者 修订 手稿 。John 还 为 多 本 计算 杂志 提供 技术 编辑 服务 。John 
的 博客 网 址 是 http://blog.johnmuellerbooks.com/。 


致 


谢 
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设计 师 等 提供 有 价值 的 帮助 ， 残 不 可 能 编写 出 局 质量 的 书籍 。 编 程 技术 日 新 月 异 ， 在 有 效 技术 过 时 之 前 ， 个 人 
无 法 攒 一 己 之 力 完 成 所 有 这 些 任务 。 正 因为 如 此 ， 作 者 只 有 与 伟大 的 团队 合作 ， 才 能 很 快 把 本 书 的 所 有 组 件 组 
合 在 一 起 ， 才 能 确保 把 最 新 信息 传达 给 读者 ， 儿 助 恋 者 了 解 最 新 功能 。 感 谢 Tom Dinse 很 好 地 完成 了 项 目 管 理 
和 全 书 的 技术 评审 工作 ， 感 谢 John Mueller 在 整个 过 程 中 做 技术 审 得 和 提供 建议 。 最 后 ， 感 谢 在 敌后 帮助 本 书 
出 版 的 所 有 人 员 。 
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C# 是 Microsoft F 2000 年 7 月 推出 .NET Framework 的 第 1 版 时 提供 的 一 种 全 新 语言 。C# 从 那 时 起 迅速 流 
行 开 来 ， 成 为 使 用 NET Framework 的 桌面 、Web、 云 和 跨 平 台 开 发 人 员 无 可 争议 的 选择 。 他 们 喜欢 C# 的 一 个 
原因 是 其 继承 目 C/C++ 的 简洁 明了 的 语法 ， 这 种 语法 简化 了 以 前 给 程序 员 市 来 困扰 的 一 些 问题 。 尽 省 做 了 这 些 
人 简化， 但 C# 仍 保持 了 C++ 原 有 的 功能 ， 所 以 现在 没 理由 不 从 C++ 转 同 C#。C# 语 言 并 不 难 ， 也 非常 适合 开发 人 
员 学 习 基 本 编程 技术 。 易 于 学 习 ， 再 加 上 NET Framework 的 功能 ， 使 C# 成 为 开始 你 编程 生涯 的 绝 佳 方式 。 

C# 的 最 新 版 本 CH 7 是 NET Framework 4.7 的 一 部 分 ， 它 建立 在 已 有 的 成 功 基础 之 上， 还 添加 了 一 些 更 吸引 
人 的 功能 。Visual Studio 的 最 新 版 本 Visual Studio 2017 和 开发 工具 的 Visual Studio Code 2017 系列 也 有 许多 变化 和 
改进 ， 这 大 大 简化 了 编程 工作 ， 显 著 提 高 了 效率 。 

本 书 将 全 面 介绍 C# 编 程 的 所 有 知识 ， 从 该 语言 本 喘 一 直到 呆 面 编程 、 云 编程 和 跨 平 台 编 程 ， 骨 到 数据 源 的 
使 用 ， 最 后 是 一 些 新 的 高 级 技术 。 我 们 还 将 学 习 Visual Studio 2017 的 功能 和 利用 它 开发 应 用 程序 的 各 种 方式 。 

本 书 文 笔 优 美 流 畅 ， 阐 述 清 晰 ， 每 一 章 都 以 前 面 草 节 的 内 容 为 基础 ， 便 于 读者 擎 握 高 级 技术 。 每 个 概念 都 
会 根据 需要 来 介绍 和 讨论 ， 而 不 会 突然 冒 出 某 个 技术 术语 来 妨碍 读者 的 阅读 和 理解 。 本 书 尽 量 减 少 使 用 的 技术 
术语 数量 ， 但 如 有 必要 ， 将 根据 上 下 文 进行 正确 的 定义 和 布置 。 

本 书 作 者 都 是 各 自 领 域 的 专家 , 都 是 C# 语 言 和 .NET Framework 的 爱好 者 , 没 人 比 他 们 更 有 资格 讲授 C# 了 ， 
他 们 将 在 你 擎 握 从 基本 原理 到 蜗 级 拉 术 的 过 程 中 为 你 保罗 护航 。 际 基础 知识 外 ， 本 书 还 有 许多 有 蔓 的 提示 、 练 
习 、 完 全 成 熟 的 示例 代码 (可 从 www.wrox.com 和 https://github.com/benperk/BeginningCSharp7 下 载 )， 在 你 的 职 
WAVE SRR ABET. 
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0.1 本 书 读者 对 象 


本 书面 同 想 学 习 如 何 使 用 .NET Framework 编写 C# 程 序 的 所 有 人 。 本 书 针对 的 是 想 要 通过 学 习 一 种 干净 、 
现代 、 优 雅 的 编程 语言 来 掌握 程序 设计 的 完 完全 全 的 初学 者 。 但 是 ， 对 于 熟 自 其 他 编程 语言 、 想 要 探索 .NET 
平台 的 读者 ， 以 及 想 要 了 解 .NET 使 用 的 旗舰 语言 的 NET 开发 人 员 ， 本 书 同样 很 有 价值 。 


0.2 本 书 内 容 


本 书 前 面 的 章节 介绍 C# 语 言 本 身 ， 读 者 不 需要 具备 任何 编程 经 验 。 以 前 对 其 他 语言 有 一 定 了 解 的 开发 人 
员 ， 会 觉得 这 些 章节 的 内 容 非 常熟 悉 。C# 语 法 的 许多 方面 都 与 其 他 语言 相同 ， 许 多 结构 对 所 有 的 编程 语言 来 说 
都 是 相通 的 (例如 ， 循 环 和 分 支 结构 )。 但 是 ， 即 使 是 有 经 验 的 程序 员 也 可 以 通过 这 些 章节 理解 此 类 技术 应 用 于 
c# 的 特征 ， 从 而 从 中 获 益 。 

如 果 读者 是 编程 新 手 ， 就 应 从 头 开始 学 习 ， 了 解 基本 的 编程 概念 ， 并 熟悉 C# 和 支持 C# 的 .NET 平台 。 如 果 
读者 对 NET Framework 比较 陌生 ， 但 知道 如 何 编程 ， 就 应 阅读 第 1 章 ， 然 后 快速 跳 读 后 面 几 章 ， 这 样 就 能 掌握 
Cc# 语 言 的 应 用 方式 了 。 如 果 读者 知道 如 何 编程 ， 但 以 前 从 未 接触 过 面向 对 象 的 编程 语言 ， 就 应 从 第 8 章 开始 
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如 果 读 者 对 C# 语 言 比较 了 解 , 就 可 以 集中 精力 学 习 那 些 详细 论述 最 新 NET Framework 和 C# 语 言 开发 的 章 
TH CHARA. ZEA C# 语 言 新 增 内 容 的 相关 章节 (第 11 章 和 第 12 章 )。 

本 书童 节 的 编排 方式 可 以 达到 两 个 目的 : 可 以 按 顺 序 阅 读 这 些 革 节 , 将 其 视 为 C# 语 言 的 一 个 完整 教程 ,还 
可 以 按照 需要 深入 学 习 这 些 章节 ， 将 其 作为 一 本 参考 资料 。 

除 核 心 内 容 外 ， 从 第 3 章 开 始 ， 大 多 数 章 节 的 末尾 还 包含 一 组 习题 ， 完 成 这 些 习 题 有 助 于 读者 理解 所 学 的 
内 容 。 习 题 包括 简 单 的 选择 题 、 判 断 题 以 及 需要 修改 或 创建 应 用 程序 的 较 难 问题 。 附 录 中 给 出 了 全 部 习题 的 答 
案 。 这 些 习 题 也 可 以 通过 本 书 的 配套 网 站 www.wrox.com. 下 载 ， 它 们 是 wrox.com 代码 下 载 的 一 部 分 。 

本 书 特别 注重 与 C#7、.NET 4.7 的 一 任性 。 对 每 一 章 都 进行 了 彻 压 的 检查 ， 删 近 了 不 太 相 关 的 内 容 ， 增 加 
了 新 内 容 。 所 有 代码 痢 在 最 新 版 本 的 开发 工具 上 进行 了 测试 ， 所 有 屏 佑 截图 部 在 Windows 10 上 重新 截取 ， 以 
提供 最 新 的 窗口 和 对 话 框 。 

本 书 的 腕 点 包括 : 
增加 并 改进 了 代码 示例 。 
涵盖 C#7 ALNET 4.7 的 所 有 新 内 容 。 
增加 了 编写 跨 平台 运行 的 NET Core 和 ASPNET Core 应 用 程序 的 示例 。 
增加 了 编写 云 应 用 程序 的 示例 ， 并 使 用 Azure SDK 创建 和 访问 云 资 源 。 
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本 书 分 为 6 大 部 分 。 

e Bim: 概述 本 书 的 内 容 。 

CHAS: 介绍 C# 语 言 的 所 有 和 内容 ， 从 基础 知识 到 面 问 对 象 的 技术 ， 一 应 俱全 。 

Windows 编程 : 介绍 如 何 用 WPF 库 编 写 和 部 署 桌 面 应 用 程序 。 

云 和 跨 平 台 编 程 : 描述 云 和 踊 平 台 应 用 程序 的 开发 和 部 署 ， 包 括 Web API 的 创建 和 使 用 。 

数据 访问 : 介绍 如 何在 应 用 程序 中 使 用 数据 ， 包 括 存 储 在 硬盘 文件 中 的 数据 、 以 XML 格式 存储 的 数据 
e 其 他 技术 : 讲述 使 用 C# 和 .NET Framework 的 一 些 额外 方式 ， 包 括 WCF 和 通用 Windows 应 用 程序 。 
下 面 介 绍 本 书 5 个 重要 部 分 中 的 章节 。 


0.3.1 C# 语 言 (第 1~ 13 章 ) 


第 1 章 介 绍 C# 及 其 与 .NET 的 关系 ， 了 解 在 这 个 环境 下 编程 的 基础 知识 ， 以 及 Visual Studio 2017 与 它 的 
关系 。 
第 2 章 开 始 介绍 如 何 编写 C# 应 用 程序 ， 学 习 C# 的 语法 ， 并 将 C# 和 示例 命令 行 、Windows 应 用 程序 结合 起 
来 使 用 。 这 些 示 例 将 说 明 如 何 快速 轻松 地 启动 和 运行 C#， 并 附带 介绍 Visual Studio 开发 环境 以 及 本 书 将 要 使 用 
的 基本 窗口 和 工具 。 

接着 将 学 习 C# 语 言 的 基础 知识 。 第 3 章 介 绍 变量 的 含义 以 及 如 何 操纵 它们 。 第 4 章 将 用 流程 控制 (循环 和 
分 支 ) 改 进 应 用 程序 的 结构 ， 第 $ 章 介 绍 一 些 更 高 级 的 变量 类 型 ， 如 数组 。 第 6 章 开 始 以 函数 形式 封装 代码 ， 这 
样 就 更 易于 执行 重复 操作 ， 使 代码 更 容易 让 人 理解 。 

从 第 7 章 开 始 将 运用 C# 语 言 的 基础 知识 ， 调 试 应 用 程序 。 这 包括 在 运行 应 用 程序 时 输出 跟踪 信息 ， 使 用 
Visual Studio 查找 错误 ， 在 强大 的 调试 环境 中 找 出 解决 问题 的 办 法 。 

第 8 章 将 学 习 面 器 对 象 编程 (Object-Oriented Programming，OOP)。 自 先 了 解 这 个 术语 的 含义， 回答 “什么 
是 对 象 ? ”OOP 初 看 起 来 是 较 难 的 问题 。 我 们 将 用 一 整 章 的 篇 幅 来 介绍 它 ， 解 释 对 象 的 强大 之 处 。 直 到 该 章 尼 
最 后 才 会 真正 使 用 C# 代 码 。 

第 9 章 将 理论 知识 应 用 于 实践 ， 当 开始 在 C# 应 用 程序 中 使 用 OOP 时 ， 这 才 体 现 出 C# 的 真正 威力 。 在 第 9 
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章 介 绍 如 何 定义 类 和 接口 之 后 ， 第 10 章 将 探讨 类 成 员 (包括 字段 、 属 性 和 方法 )， 在 这 一 章 的 最 后 将 开始 创建 一 
个 扑克 有 牌 游戏 ， 这 个 游戏 将 在 后 续 章 节 中 逐步 开发 完成 ， 它 非 第 有 助 于 理解 OOP. 

*£2] f OOP 在 C# 中 的 工作 原理 后 ， 第 11 间 将 介绍 几 种 常见 的 OOP 场景 ， 包 括 处 理 对 象 集合 、 比 较 和 转 
换 对 象 。 第 12 章 讨 论 .NET 2.0 中 引入 的 一 个 非常 有 用 的 C# 特 性 一 一 泛 型 ， 利 用 它 可 以 创建 非常 灵活 的 类 。 第 
13 章 通 过 一 些 其 他 技术 (主要 是 事件 ， 它 在 Windows 编程 中 非常 重要 ) 继 续 讨 论 C# 语 言 和 OOP。 最 后 介绍 CH 
3.0/4/5/6 版 本 中 引入 的 新 特性 。 


0.3.2 Windows 编程 (第 14 章 和 第 15 章 ) 


第 14 章 开 始 介 绍 Windows 编程 的 概念 ， 理 解 在 Visual Studio 中 如 何 实现 Windows 编程 。 该 章 主要 关注 如 
何 使 用 WPF 以 图 形 化 方式 构建 梨 面 应 用 程序 ， 以 及 用 最 少 的 时 间 和 精力 创建 高 级 果 面 应 用 程序 。 你 将 和 朋 先 学 
2] WPF 编程 的 基础 知识 ， 然 后 在 该 革 和 第 15 章 逐 渐 拓 展 相 关 知 识 。 第 15 章 演 示 在 应 用 程序 中 如 何 使 用 .NET 
Framework 提供 的 丰富 控件 。 


0.33 云 和 跨 平 台 编 程 (第 16 ~ 19 章 ) 


第 16 章 首 先 描述 云 编 程 ， 再 讨论 云 优化 堆栈 。 云 环境 不 同 于 传统 的 程序 编码 方式 ， 所 以 讨论 、 定 义 了 几 个 
云 编程 模式 。 为 完成 这 一 章 ,， 需要 一 个 免费 的 Azure 账户 ,以 便 创 建 一 个 App Services Web App, 然后 使 用 Azure 
SDK 和 C#， 在 ASP.NET 4.7 Web 应 用 程序 中 创建 和 访问 存储 账户 。 

第 17 章 将 学 习 如 何 创 建 ASPNET Web API, RASKE, 然后 在 类 似 的 ASPNET 4.7 Web 应 用 程序 中 使 
用 Web API。 这 一 章 最 后 讨论 云 中 两 个 最 有 价值 的 特性 ， 硬件 资源 的 缩放 和 最 优 利用 方式 。 

第 18 章 将 介绍 NET Standard 和 NET Core， 这 两 个 工具 可 用 于 任何 应 用 程序 类 型 ， 例 如 WPF. Windows 
和 ASPNET。 新 兴 的 应 用 程序 是 可 以 跨 平 台 运行 (如 Linux 或 macOS) 的 。 该 章 介 绍 .NET Core 2.0 的 安装 指南 ， 
以 及 如 何 创建 和 实现 .NET Standard FE. 

第 19 章 将 描述 ASPNET 及 其 多 种 不 同 的 类 型 (例如 ASPNET Web Forms、ASPNET MVC fll ASPNET Core). 
该 章 末尾 的 习题 利用 了 第 18 章 的 ASPNET Web Pages 和 ASPNET Core 应 用 程序 中 所 创建 的 .NET Standard E. 


0.3.4 数据 访问 (第 20 ~ 23 章 ) 


第 20 章 介 绍 应 用 程序 如 何 将 数据 保存 到 磁盘 以 及 如 何 检 索 磁 盘 上 的 数据 (作为 简单 的 文本 文件 或 者 更 复杂 
的 数据 表示 方式 )。 该 草 还 将 讨论 如 何 压 缩 数 据 ， 以 及 如 何 监视 和 处 理 文件 系统 的 变化 。 

第 21 章 学 习 数 据 交 换 的 事实 标准 XML， 简 要 论述 ISON 格式 。 在 之 前 的 章节 中 你 接触 过 XML 几 次 ， 而 
该 章 将 讨论 XML 的 基本 规则 ， 论 述 XML 的 所 有 功能 。 

该 部 分 的 其 余 章节 介绍 LINQ( 这 是 内 置 于 .NET Framework 最 新 版 本 中 的 查询 语言 )。 第 22 章 简要 介绍 
LINQ。 第 23 章 讨 论 如 何 使 用 LINQ 访问 数据 库 和 其 他 数据 。 


0.3.5 其 他 技术 (第 24 章 和 第 25 章 ) 


第 24 章 简 要 介绍 Windows Communication Foundation(WCF)， 它 为 在 企业 级 以 编程 方式 跟 本 地 网 络 和 
Internet 访问 信息 和 功能 提供 了 许多 工具 。 该 章 将 介绍 如 何以 平台 无 关 的 方式 使 用 WCF， 同 Web 应 用 程序 和 果 
面 应 用 程序 公开 复杂 的 数据 和 功能 。 

第 25 章 展 示 如 何 创建 通用 Windows 应 用 程序 ， 这 是 Windows 新 增 的 内 容 。 该 章 建立 在 第 14 章 和 第 15 3 
的 基础 上 上， 介绍 如 何 创 建 可 以 运行 在 所 有 Windows 平台 上 的 Windows 应 用 程序 。 
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0.4 使 用 本 书 的 要 求 


本 书 中 C# 和 .NET Framework 的 代码 和 描述 都 适用 于 C#7 和 .NET 4.7。 除 了 .NET Framework 之 外 ， 不 需要 
其 他 组 件 吉 可 以 理解 本 书 的 这 个 方面 ， 但 许多 示例 都 需要 使 用 开 友 工具 。 本 书 将 Visual Studio Community 2017 
作为 主要 开发 工具 。 使 用 Visual Studio Community 2017 来 创建 Windows 应 用 程 友 、 云 应 用 程序 、 跨 平台 的 应 用 
程序 ， 以 及 访问 数据 库 的 SQL Server Express 应 用 程序 。 一 些 功能 只 能 在 Visual Studio 2017 中 使 用 ， 但 这 不 会 
妨碍 练习 本 书 的 示例 。 


05 BENE 
为 了 帮助 读者 在 阅读 本 书 的 过 程 中 获取 最 多 信息 ， 并 随时 了 解 当前 处 理 的 事项 ， 本 书 使 用 了 许多 约定 。 


警告 : 
带 有 仪 告 图 标的 方 框 包含 重要 且 应 该 记 住 的 信息 ， 这 些 信息 与 周围 的 文字 直接 关联 。 


提示 : 
带 有 铅笔 图 标的 方 框 表示 注释 、 提 示 、 上 暗示 、 技 巧 或 对 当前 讨论 的 弦 外 之 音 。 


本 书 通 过 两 种 方式 来 显示 代码 : 
e 对 于 大 多 数 代 码 示 例 ， 使 用 没有 突出 显示 的 等 宽 字 体 来 表示 。 
e 对 在 当前 上 下 文中 特别 重要 的 代码 ， 用 粗 体 学 强调 显示 。 


0.6 源 代码 


在 读者 学 习 本 书 中 的 示例 时 ， 可 以 手工 输入 所 有 的 代码 ， 也 可 以 使 用 本 书 附 市 的 源 代码 文件 。 本 书 使 用 的 
所 有 源 代码 都 可 以 从 本 书 合 作 站 点 www.wrox.com 或 https://github.com/benperk/BeginningCSharp7 bl. 

在 站 点 www.wrox.com 上 通过 搜索 本 书 的 英文 版 ISBN(9 78-1-119-45868- 5 ) 可 以 获得 源 
代码 。 当 前 所 有 可 下 载 代 码 的 Wrox 图书 的 完整 列表 可 以 通过 www.wrox.conydynamic/books/download.aspx 获得 。 

www.wrox.com 上 的 大 部 分 代码 都 以 ZIP、RAR 或 者 适合 平台 的 类 似 归档 格式 进行 压缩。 下载 代码 后 ， 
只 需要 用 合适 的 解压 缩 工 具 对 它 进 行 解压 缩 即 可 。 

此 外 ， 读 者 也 可 扫描 封 展 的 二 维 码 下 载 示例 代码 。 


注意 : 

由 于 许多 图 书 的 标题 都 很 类 似 ， 因 此 按 ISBN 搜索 是 最 简单 的 ， 本 书 英文 版 的 ISBN 是 978-1-119-45868-5. 

另外 ， 也 可 以 进入 http://www.wrox.com/dynamic/books/download.aspx 上 的 Wrox 代码 下 载 主页 ， 查 看 本 书 
和 所 有 其 他 Wrox 图 书 的 代码 。 


0.7 HRR 


尽 官 我 们 已 经 尽 了 各 种 努力 来 傈 证 文本 或 代码 中 不 出 现 错误 ， 但 错误 总 是 难免 的 ， 如 果 你 在 本 书 中 找到 了 
错误 ， 例 如 拼写 错误 或 代码 错误 ， 请 告诉 我 们 ， 我 们 将 非 第 感激 。 通 过 勘误 表 ， 可 以 让 其 他 读者 避免 受挫 ， 当 
然 ， 这 还 有 助 于 提供 更 高 质量 的 信息 。 

要 在 网 站 上 找到 本 书 英 文 版 的 勘误 表 ， 可 以 登录 wwwwrox.com， 单 击 Errata 链接 。 在 这 个 页 面 上 可 以 看 
到 Wrox 编辑 已 提交 和 张贴 的 所 有 勘误 项 。 
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如 果 在 Book Errata 页 面 上 没有 看 到 你 找 出 的 错误 , 请 进入 www.wrox.com/contact/techsupport.shtml, 十 写 表 单 ， 
发 送 电子 邮件 ， 我 们 就 会 检查 你 发 布 的 信息 。 如 果 是 正确 的 ， 就 在 本 书 的 勘误 表 中 张贴 一 条 消息 ， 我 们 将 在 本 


书 的 后 续 版 本 中 采用 。 
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REAR: 

e NET Framework 的 含义 
e CHINAS 

e Visual Studio 2017 


本 书 第 I 部 分 将 介绍 使 用 最 新 版 本 的 C# 语言 所 需 的 基础 知识 。 第 1 章 将 概述 .NET Framework 和 C£, 
包括 这 两 项 技术 的 含义 、 作 用 及 相互 关系 。 

自 先 讨论 .NET Framework。 这 种 技术 包含 的 许多 概念 初 看 起 来 都 不 是 很 容易 掌握 。 也 束 是 说 ， 我 们 必须 在 很 
短 的 篇 幅 里 介绍 许多 新 概念 ， 但 快速 浏览 这 些 基 础 知识 对 于 理解 如 何 利 用 C# 进 行 编程 是 非常 重要 的 ， 本 书后 面 将 
详细 论述 这 里 提 到 的 许多 话题 。 

之 后 ， 本 草 将 讨论 CHAD, 包括 它 的 起 源 以 及 与 Ct+ 的 类 似 之 处 。 最 后 介绍 本 书 中 使 用 的 主要 工具 : Visual 
Studio (VS). Visual Studio 2017 是 Microsoft 提供 的 一 系列 开发 环境 中 最 新 的 一 个 ， 本 书 将 用 到 它 的 各 种 新 功能 
(包括 对 Windows Store、Azure 和 跨 平 台 应 用 程序 的 完整 支持 )。 


1.1 .NET Framework HEX 


NET Framework( 现 在 最 新 版 本 是 4.7) 是 Microsoft 为 开发 应 用 程序 而 创建 的 一 个 具有 半 命 意义 的 平台 。 这 
人 句 话 最 有 趣 的 地 方 在 于 它 的 广义 性 ， 但 这 是 有 原因 的 。 首 先 ， 注 意 这 人 句 话 没有 说 “在 Windows 操作 系统 上 开发 
WHET”. AE NET Framework 的 Microsoft 版 本 运行 在 Windows 操作 系统 和 Windows Mobile 操作 系统 上 ， 
但 它 也 有 运行 在 其 他 操作 系统 上 的 版 本 ， 例 如 Mono, Mono 是 .NET Framework 的 开源 版 本 (包含 CES ERS), 
该 版 本 可 以 运行 在 几 个 操作 系统 上 ， 包 括 各 种 Linux RASA macos, YE http:/www.mono-project.com. 

Mono 是 .NET 生态 系统 的 重要 组 成 部 分 ， 对 于 使 用 Xamarin 创建 客户 病 应 用 程序 尤其 重要 。Microsoft 还 创 
建 了 一 个 路 平台 的 开源 库 .NET Core (https://github.com/dotnet/core), WJJ Mono 和 .NET Core 框架 提供 帮助 。 这 
两 个 生态 系统 下 的 程序 员 可 以 使 用 彼此 库 中 的 示例 来 提高 性 能 和 安全 性 ， 以 及 提供 更 多 的 语言 功能 一 一 协作 是 
开源 社区 的 一 个 关键 特征 。 

另外 ， 上 面 给 出 的 NET Framework 定义 并 未 限制 应 用 程序 的 类 型 。 可 以 使 用 .NET Framework 创建 果 面 应 
用 程序 、Windows Store(UWP) 应 用 程序 、 云 /Web 应 用 程序 、Web API 和 其 他 各 种 类 型 的 应 用 程序 。 男 外 注意 ， 
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对 于 Web、 云 和 Web API 应 用 程序 ， 按 照 定义 ， 它们 是 多 平台 的 应 用 程序 ， 因 为 任何 市 有 Web 浏览 器 的 系统 都 
可 以 访问 它们 。 

NET Framework 的 设计 方式 确保 它 可 以 用 于 各 种 语言 , 包括 本 书 介 绍 的 C# 语 言 , 以 及 CH. FA, JavaScript. 
Visual Basic 甚至 一 些 旧 语言 ， 如 COBOL。 为 此 ， 还 推出 了 这 些 语言 的 .NET 版 本 ， 目 前 还 在 不 断 推 出 更 多 版 本 。 
要 获得 这 些 语言 的 列表 , 可 以 访问 https://msdn.microsoft.com/en-us/library/ee822860(v=vs.100).aspx. TA eB Ga 
都 可 以 访问 .NET Framework， 它 们 彼此 之 间 还 可 以 通信 。C# 开 发 人 员 可 以 使 用 Visual Basic 程序 员 编 写 的 代码 ， 

所 有 这 些 提供 了 意 想不到 的 多 样 性 ， 这 也 是 .NET Framework 具有 诱 人 前 景 的 部 分 原因 。 


1.1.1 .NET Framework 的 内 容 


NET Framework 主要 包含 一 个 庞大 的 代码 库 ， 可 以 在 客户 疹 或 服务 器 问 语 言 (如 CH) FA ara AR 2 ig FE 
(Object-Oriented Programming; OOP) 技 术 来 使 用 这 些 代 码 。 这 个 库 分 为 多 个 不 同 的 模块 ， 这 样 就 可 以 根据 希望 
得 到 的 结果 来 选择 使 用 其 中 的 各 个 部 分 。 例 如 ， 一 个 模块 包含 Windows 应 用 程序 的 构件 ， 另 一 个 模块 包含 网 络 
编程 的 代码 块 ， 还 有 一 个 模块 包含 Web 开发 的 代码 块 。 一 些 模块 还 分 为 更 具体 的 子 模块 ， 例 如 ， 在 Web 开发 
模块 中 ， 有 用 于 创建 Web 服务 的 子 模块 。 

其 目的 是 ， 不 同 的 操作 系统 可 以 根据 各 目的 特征 ， 文 持 其 中 的 部 分 或 全 部 模块 。 例 如 ， 重 能 手机 文 持 所 有 
的 基本 .NET 功能 ， 但 不 需要 某 些 更 高 级 的 模块 。 

部 分 .NET Framework 库 定 义 了 一 些 基本 类 型 。 类 型 是 数据 的 一 种 表达 方式 ， 指 定 最 基本 类 型 (如 32 WU 
写 的 整 型 ) 有 助 于 使 用 .NET Framework 的 各 种 语言 之 间 进 行 交 互 操 作 ， 这 称 为 通用 类 型 系统 (Common Type 
System, CTS). 

除 提供 这 个 库 外 ，.NET Framework 还 包含 NET 公共 语言 运行 库 (Common Language Runtime, CLR), E Ti 
责 管 理 用 NET 库 开 发 的 所 有 应 用 程序 的 执行 。 


1.1.2 .NET Standard 和 .NET Core 


Microsoft 最 初创 建 .NET Framework 时 ， 将 其 设 为 在 多 平台 上 运行 ， 但 还 没有 业界 接受 的 开源 分 文 的 概念 。 
如 今 , ( 通 贡 是 ) 在 GitHub E, 项 目 可 以 被 分 文 并 在 多 个 平台 上 定制 运行 。 例 如 , NET Compact Framework 和 .NET 
Micro Framework 是 .NET Framework Hart, WUS NET Core 一 样 。.NET Core 是 进行 路 平台 代码 开发 的 最 优 
化 的 解决 方案 。 每 个 .NET Framework 的 分 文 都 有 一 组 具体 的 要 求 和 目标 ， 正 是 这 些 需 求 和 目标 众生 了 对 应 的 
4] Xo 

NET Framework 中 包含 一 组 基 关 库 (Base Class Libraries，BCL)， 这 些 库 中 包含 的 API 用 于 大 多 数 开 发 人 员 
需要 程序 完成 的 基本 操作 ， 例 如 访问 文件 、 处 理 字 符 串 、 管 理 流 、 将 数据 保存 到 集合 中 、 安 全 属性 等 。 这 些 基 
AST BE HY SEEN S FE [|] MJ. NET Framework 版 本 中 是 不 同 的 。 这 束 要 求 开 友人 员 根 据 应 用 程序 运行 的 平台 ， 针 
对 应 用 程序 的 不 同 分 文 或 版 本 去 学 习 、 开 发 和 管理 多 个 BCL。.NET Standard 已 经 解决 了 这 个 问题 。 

Microsoft 的 期 望 是 ， 这 个 分 支 概念 很 快 将 导致 更 多 的 .NET Framework 版 本 出 现 。 版 本 数量 的 增加 ， 就 需要 
有 一 组 标准 的 基本 编程 API 来 处 理 每 种 分 支 与 版 本 。 夺 没有 这 个 跨 平 台 的 基本 库 ， 开 发 和 支持 的 难度 会 阻止 这 
些 分 文 版 本 被 迅速 及 用。 人 简 言 之 ，NET Standard 是 一 个 类 库 , 它 提 供 的 API 文 持 使 用 了 NET Platform 的 应 用 程 
序 的 任何 分 文 或 版 本 。 


1.1.3 使 用 NET Framework 和 .NET Core 编写 应 用 程序 


使 用 .NET Framework 或 .NET Core 编写 应 用 程序 ,就 是 使 用 .NET 代码 库 编 写 代 码 ( 使 用 支持 .NET Framework 
的 任何 一 种 语言 )。 本 书 用 Visual Studio 进行 开发 ，Visual Studio 是 一 种 强大 的 集成 开发 环境 ， 支 持 CARH 
省 和 非 托 管 CH. Visual Basic 和 其 他 一 些 语言 )。 
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这 个 环境 的 优点 是 便于 把 .NET 功能 集成 到 代码 中 。 我 们 创建 的 代码 完全 是 C# 代 码 ， 但 使 用 了 .NET 
Framework， 并 在 需要 时 利用 了 Visual Studio 中 的 其 他 工具 。 

为 执行 C# 代 码 ， 必 须 把 它们 转换 为 目标 操作 系统 能 理解 的 语言 ， 即 本 机 代码 (native code)。 这 种 转换 称 为 
编 详 (compiling) 代 码 ， 由 编 诺 器 执行 。 但 在 NET Framework 和 .NET Core 下 ， 此 过 程 包括 两 个 阶段 。 


1. CILL 和 JIT 


在 编译 使 用 .NET Framework 或 NET Core 库 的 代码 时 ， 不 是 立即 创建 专用 于 操作 系统 的 本 机 代码 ， 而 是 把 
代码 编译 为 通用 中 间 语 言 (Common Intermediate Language, CILA RIB, 这 些 代 人 码 并 非 专 门 用 于 任何 一 种 操作 系统 ， 
也 非 专 门 用 于 C#。 其 他 .NET 语言 (如 Visual Basic .NET 或 F 胡 也 会 在 第 一 阶段 编 详 为 这 种 语言 。 开 友 C# 应 用 程 
序 时 ， 这 个 编 详 步骤 由 Visual Studio 完成 。 

显然 ， 要 执行 应 用 程序 ， 必 须 完 成 更 多 工作 ， 这 是 Just-In-Time(JIT) 编 译 器 的 任务 ， 它 把 CIL 编译 为 专用 于 
OS 和 目标 机 器 架构 的 本 机 代码 。 这 样 OS 才能 执行 应 用 程 厅 。 这 里 编译 器 的 名 称 Just-In-Time 反映 了 CIL 代码 
仪 在 需要 时 才 编 译 的 事实 。 这 种 编译 可 以 在 应 用 程序 的 运行 过 程 中 动态 发 生 ， 不 过 开发 人 员 一 般 不 需要 关心 
这 个 过 程 。 除 非 要 编写 性 能 十 分 关键 的 高 级 代码 ， 人 耕 则 知道 这 个 编 详 过 程 会 在 后 台 目 动 进行 ， 并 不 需要 人 工 干 
预 束 可 以 了 。 

过 去 ,经营 需要 把 代码 编译 为 几 个 应 用 程序 ， 每 个 应 用 程序 都 用 于 特定 的 操作 系统 和 CPU 架构 。 这 通 津 是 
一 种 优化 形式 (例如 ， 为 了 让 代码 在 AMD 心 厂 组 上 运行 得 更 快 )， 但 有 了 时 则 是 非常 重要 的 (例如 ， 使 应 用 程序 可 
以 同时 工作 在 Win9x 和 WinNT/2000 环境 下 )。 现 在 就 没 必要 了 ， 因 为 JIT 编译 占 使 用 CIL 代码 ， 而 CIL 代码 是 
独立 于 计算 机 、 操 作 系 统 和 CPU 的 。 目 前 有 几 种 JIT Suites, BERR PEAS ABA TARI, CLR/CoreCLR 
会 使 用 合适 的 编 诺 器 创建 所 需 的 本 机 代码 。 

这 样 ， 开 发 人 员 需 要 做 的 工作 就 比较 少 了 。 实 际 上 ， 可 以 忽略 与 系统 相关 的 细节 ， 将 注意 力 集中 在 代码 的 
功能 上 就 够 了 。 


提示 : 

读者 可 能 遇 到 过 Microsoft Intermediate Language(MSIL) 这 一 术语 ， 它 是 CIL 原来 的 名 称 ， 许 多 开发 人 员 仍 
沿用 这 个 术语 。 可 以 访问 https://en-wikipedia.org/wiki/Common Intermediate Language 获取 CIL 的 更 多 信息 。 

2. 程序 集 

编译 应 用 程序 时 , 所 创建 的 CIL 代码 存储 在 一 个 程序 集 (assembly) 中 。 程 序 集 包 括 可 执行 的 应 用 程序 文件 (这 
些 文 件 可 以 直接 在 Windows 上 运行 ， 不 需要 其 他 程序 ， 其 扩展 名 是 .exe) 和 其 他 应 用 程序 使 用 的 库 ( 其 扩展 名 
7& dll). 

除 包含 CIL 外 , 程序 集 还 包含 元 信息 ( 即 程 序 集中 包含 的 数据 的 信息 , 也 称 为 元 数据 ) 和 一 些 可 选 的 资源 (CIL 
使 用 的 其 他 数据 ， 例 如 ， 声 音 文件 和 图 片 )。 元 信息 允许 程序 集 是 完全 目 拍 述 的 。 不 需要 其 他 信息 就 可 以 使 用 程 
厅 集 ， 也 就 是 说 ， 我 们 不 会 遇 到 没有 把 需要 的 数据 添加 到 系统 注册 表 中 这 样 的 问题 ， 而 在 使 用 其 他 平台 进行 开 
发 时 这 个 问题 当当 出 现 。 

因此 ， 部 彰 应 用 程序 就 非常 简单 了 ， 只 需要 把 文件 复制 到 远程 计算 机 上 的 目录 下 即 可 。 因 为 不 需要 目标 系 
统 上 的 其 他 信息 ， 所 以 对 于 针对 .NET Framework 的 应 用 程序 ， 只 需要 从 该 目录 中 运行 可 执行 文件 即 可 (假定 安 
A f NET CLR)。 而 对 于 针对 .NET Core 的 应 用 程序 ， 运 行 该 程序 需要 的 所 有 模块 都 包含 在 部 普 包 中 ， 不 需要 进 
行 其 他 配置 。 

在 .NET Framework 中 ,不 必 把 运行 应 用 程序 需要 的 所 有 信息 都 安 计 到 一 个 地 方 。 可 以 编写 一 些 代码 来 执行 
多 个 应 用 程序 所 要 求 的 任务 。 此 时 ， 通 和 贡 把 这 些 可 重用 的 代码 放 在 所 有 应 用 程序 都 可 以 访问 的 地 方 。 在 -NET 
Framework 中 ， 这 个 地 方 是 全 局 程序 集 缓存 (Global Assembly Cache，GAC)， 把 代码 放 在 这 个 缓存 中 十 分 商 单 ， 
只 需要 把 包含 代码 的 程序 集 放 在 包含 该 缓存 的 目录 中 即 可 。 


6 | 第 | 部 分 CH B 


Di} 


3. 托管 代码 


在 将 代码 编译 为 CIL， 骨 用 SIT 编 详 占 将 它 编译 为 本 机 代码 后 ，CLR/CoreCLR 的 任务 尚未 全 部 完成 ， 还 需 
要 常理 正在 执行 的 用 .NET Framework 和 .NET Core 编写 的 代码 (这 个 执行 代码 的 阶段 通常 称 为 运行 时 (runtime))。 
Bl CLR/CoreCLR 管理 着 应 用 程序 ， 其 方式 是 管理 内 存 、 处 理 安全 性 以 及 允许 进行 路 语言 调试 等 。 相 反 ， 不 受 
CLR/CoreCLR 控制 运行 的 应 用 程序 属于 非 托管 类 型 ， 某 些 语言 (如 C+H) 可 以 用 于 编写 此 类 应 用 程序 ， 例 如 ， 访 
问 操作 系统 的 底层 功能 的 应 用 程序 。 但 是 在 C# 中 ， 只 能 编写 在 托管 环境 下 运行 的 代码 。 我 们 将 使 用 
CLR/CoreCLR 的 托管 功能 ， 让 .NET 处 理 与 操作 系统 的 任何 交互 。 

4. 垃圾 回收 

托管 代码 最 重要 的 一 个 功能 是 垃圾 回收 (garbage collection)。 这 种 .NET 方法 可 确保 应 用 程序 不 再 使 用 某 些 内 
存 时 ， 就 会 完全 释放 这 些 内 存 。 在 .NET 推出 以 前 ， 这 项 工作 主要 由 程序 员 人 负责， 代码 中 的 几 个 简单 错误 会 把 
大 块 内 存 分 配 到 错误 的 地 方 ， 使 这 些 内 存 神秘 失踪 。 这 通常 意味 着 计算 机 的 速度 逐渐 减 慢 ， 最 终 导致 系统 
HA Tot o 

NET 垃 圾 回收 会 定期 检查 计算 机 的 内 存 ， 从 中 删除 不 再 需要 的 内 容 。 执 行 垃 圾 回收 的 时 间 并 不 固定 ， 可 能 
一 秒 钟 内 会 进行 数 干 次 的 检查 ， 也 可 能 每 几 秒 钟 才 检 查 一 次 ， 不 过 一 定 会 进行 检查 。 

这 里 要 给 程序 员 一 些 提 示 。 因 为 是 在 不 可 预知 的 时 间 执 行 这 项 工作 ， 所 以 在 设计 应 用 程序 时 ， 必 须 留 意 这 
一 点 。 需 要 许多 内 存 才能 运行 的 代码 应 自行 完成 清理 工作 ， 而 不 是 坐等 垃圾 回收 ， 但 这 不 像 听 起 来 那样 难 。 


5. 把 它们 组 合 在 一 起 


在 继续 学 习 之 前 ， 先 总 结 一 下 上 述 所 讨论 的 创建 NET 应 用 程序 所 需 的 步骤 : 
(1) 使 用 某 种 .NET 兼容 语言 (如 C 均 编写 应 用 程序 代码 ， 如 图 1-1 所 示 。 
(2) 把 代码 编译 为 CILL， 存 储 在 程序 集中 ， 如 图 1-2 Br. 


CHG 
1-1 1-2 
(3) 在 执行 代码 时 (如 果 这 是 一 个 可 执行 文件 ， 束 上 日 动 运行 ， 或 者 在 其 他 代码 使 用 它 时 运行 )， 首 先 必 须 使 用 


JIT 编 详 项 将 代码 编 详 为 本 机 代码 ， 如 图 1-3 所 示 。 


图 1-3 


(4) ŒE H] CLR/CoreCLR 环境 下 运行 本 机 代码 ， 以 及 其 他 应 用 程序 或 进程 ， 如 图 1-4 所 示 。 
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NET CLR/CoreCLR 


本 机 代码 


6. 链接 


在 上 述 过 程 中 还 有 一 点 要 注意 。 在 第 (2) 步 中 编译 为 CIL 的 C# 代 码 未 必 包 含 在 一 个 单独 的 文件 中 ， 可 以 把 
应 用 程序 代码 放 在 多 个 源 代码 文件 中 ， 再 把 它们 编 详 到 一 个 单独 的 程序 集中 。 这 个 过 程 称 为 链接 (inking)， 走 非 
弟 有 用 的 。 原 因 是 处 理 几 个 较 小 的 文件 比 处 理 一 个 大 文件 要 简单 得 多 。 可 以 把 逻辑 上 相关 的 代码 分 解 到 一 个 文 
件 中 ， 以 便 单 独 进行 处 理 ， 这 也 更 便于 在 需要 时 找到 特定 的 代码 块 ， 让 开发 小 组 把 编程 工作 分 解 为 一 些 可 定理 
的 块 ， 让 每 个 人 编写 一 小 块 代码 ， 而 不 会 破坏 已 编 与 好 的 代码 部 分 或 其 他 人 正在 处 理 的 部 分 。 


12 C# 的 含义 


如 上 所 述 ，C# 是 可 用 于 创建 要 运行 在 NET CLR/CoreCLR 上 的 应 用 程序 的 语言 之 一 。 它 从 C 和 C++ 语言 演 
化 而 来 ， 是 Microsoft 专门 为 使 用 .NET 平台 而 创建 的 。C# 吸 取 了 以 往 语言 失败 的 教训 ， 融 合 了 其 他 语言 的 许多 
优点 ， 并 解决 了 它们 存在 的 问题 。 

使 用 C# 开 发 应 用 程序 比 使 用 C++ 简单 ， 因 为 其 语法 更 简单 。 但 C# 是 一 种 强大 的 语言， 在 C++ 中 能 完成 的 
任务 几乎 者 能 利用 C# 完 成 。 虽然 如 此 ，C# 中 与 C++ 局 级 功能 等 价 的 功能 (例如 直接 访问 和 处 理 系统 内 存 )， 只 能 
在 标记 为 “unsafe” 的 代码 中 使 用 。 顾 名 忠义 ， 这 种 高 级 编程 技术 存在 沟 在 威胁 ， 因 为 它 可 能 上 黎 震 系 统 中 重要 
的 内 存 块 ， 导 致 严重 后 果 。 因 此 ， 本 书 不 讨论 这 个 问题 。 

CHARD E E C++ 代码 略 长 一 些 。 这 是 因为 C# 是 一 种 类 型 安全 的 语言 (与 C++ 不 同 )。 在 外 行人 看 来 ,这 表 
示 一 旦 为 条 个 数据 指定 了 类 型 ， 就 不 能 转换 为 男 一 种 不 相关 的 类 型 。 所 以 ， 在 类 型 之 间 转 换 时 ， 必 须 避 守 严 格 
的 规则 。 执 行 相同 的 任务 时 ， 用 C# 编 写 的 代码 通常 比 用 C++ 编写 的 代码 长 。 但 C# 人 代码 更 健壮 ， 调 试 起 来 也 比 
H, NET 始终 可 以 随时 跟踪 数据 的 类 型 。 在 C# 中 ， 不 能 完成 诸如 “把 4 字 节 的 内 存 分 配给 这 个 数据 后 ， 
我 们 使 其 有 10 字 节 长 ， 并 把 它 解 释 为 和 ”等 任务 ， 但 这 并 不 是 一 件 坏事 。 

C# 只 是 用 于 .NET 开发 的 一 种 语言 ， 但 它 是 最 好 的 一 种 语 译 。C# 的 优点 是 ， 它 是 唯一 彻头彻尾 为 .NET 
Framework 设计 的 语言 , 是 在 移植 到 其 他 操作 系统 上 的 .NET 版 本 中 使 用 的 主要 语言 。 要 使 诸如 Visual Basic NET 
的 语言 尽 可 能 类 似 于 其 以 前 的 语言 ， 且 仍 遵循 CLR/CoreCLR， 就 不 能 完全 支持 .NET 代码 库 的 某 些 功能 ， 至 少 
mi de AT LIT] TR GAS e 

C£ BET FH. NET Framework 代码 库 提供 的 每 种 功能 ， 但 并 非 所 有 的 功能 都 已 移植 到 .NET Core. MH, NET 
的 每 个 新 版 本 都 在 C# 语 言 中 添加 了 新 功能 ， 满 足 了 开 友 人 员 的 要 求 ， 使 之 更 强大 。 


1.2.1 用 C# 能 编写 什么 样 的 应 用 程序 


如 前 所 述 ，.NET Framework 没有 限制 应 用 程序 的 类 型 。C# 使 用 的 是 .NET Framework， 所 以 也 没有 限制 应 用 
程序 的 类 型 (但 是 , 目前 使 用 .NET Core 仅 可 以 编写 Console 和 ASPNET 应 用 程序 )。 这 里 仅 讨论 几 种 第 见 的 应 用 
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Dll 


e SAMAR ”这些 应 用 程序 (如 Microsoft Office) 具 有 我 们 很 熟悉 的 Windows 外 观 和 操作 方式 ， 使 
用 .NET Framework 的 Windows Presentation Foundation(WPF) 模 块 就 可 以 简便 地 生成 这 种 应 用 程序 ,WPF 
模块 是 一 个 控件 库 ， 其 中 的 控件 (例如 按钮 、 工 具 栏 和 玉音 等 ) 可 用 于 建立 Windows HPA BD. 

e Windows Store 应 用 程序 这 是 Windows 8 中 引入 的 一 类 新 的 应 用 程序 。 此 类 应 用 程序 主要 和 针对 触摸 

设备 设计 ， 通 常 全 屏 运 行 ， 侧 重点 在 于 简洁 清晰 。 创 建 这 类 应 用 程序 的 方式 有 多 种 ， 包 括 使 用 WPF. 

e z/Web 应 用 程 订 NET Framework 和 和 .NET Core 包括 一 个 动态 生成 Web 内 容 的 强大 系统 一 一 

ASP.NET, 允许 进行 个 性 化 和 实现 安全 性 等 .另外 , 这 些 应 用 程序 可 以 在 云 中 驻 留 和 访问 , 例如 Microsoft 
Azure 平台 。 
e Web API 这 是 建 并 REST 风格 的 HTTP 服务 的 理想 框架 ， 支 持 许多 客户 症 ， 包 括 移动 设备 和 浏览 器 。 
e WCF 服务 ”这 是 一 种 灵活 创建 各 种 分 布 式 应 用 程序 的 方式 。 使 用 WCF 服务 可 以 通过 局 域 网 或 Internet 
交换 几乎 各 种 数据 。 无 论 使 用 什么 语言 创建 WCF 服务 ， 也 无 论 WCF 服务 驻 留 在 什么 系统 上 ， 都 使 用 
一 样 简单 的 语法 。 

这 些 类 型 的 应 用 程序 也 可 能 需要 某 种 形式 的 数据 库 访 问 ， 这 可 以 通过 .NET Framework 的 Active Data 
Objects .NET(ADO.NET) 部 分 、ADO.NET Entity Framework 或 CH 的 LINQ(Language Integrated Query) 功 能 来 实 
现 。 对 于 需要 数据 库 访 问 的 NET Core 应 用 程序 ， 将 使 用 Entity Framework Core 库 。 也 可 以 使 用 许多 其 他 资源 ， 
例如 ， 创 建 联 网 组 件 、 输 出 图 形 、 执 行 复杂 数学 任务 的 工具 来 实现 。 


1.2.2 本 书 中 的 CH 


KPF 工 部 分 介绍 C# 语 言 的 语法 和 用 法 ， 但 不 过 分 强调 .NET Framework 或 NET Core。 这 是 必需 的 ， 因 为 
我 们 不 能 没有 一 点 儿 C# 编 程 基 础 就 使 用 .NET Framework 或 NET Core。 首 先 介绍 一 些 比较 简单 的 内 容 ， 把 较 复 
A EJ Hel [A] XT RAW FE (Object-Oriented Programming，OOP) 主 题 放 在 基础 知识 的 后 面 论 述 。 假 定 读者 没有 一 点 儿 编 
程 的 知识 ， 这 些 是 首要 原则 。 

学 习 了 基础 知识 后 ， 本 书 还 将 介绍 如 何 开发 更 复杂 、 更 有 用 的 应 用 程序 。 本 书 第 开 部 分 将 研究 Windows 编 
程 ， 第 部 分 将 讲述 云 和 路 平台 编程 ， 第 区 部 分 将 介绍 数据 访问 (ORM 数据 库 概 念 、 文 件 系统 和 XML 数据 ) 和 
LINQ, $8 V 部 分 将 详细 讨论 WCE 和 Windows Store 应 用 程序 编程 。 


1.3 Visual Studio 2017 


本 书 使 用 Visual Studio 2017 开发 工具 进行 所 有 的 C# 编 程 ， 包 括 简单 的 命令 行 应 用 程序 ， 乃 至 较 复杂 的 项 
目 类 型 。Visual Studio 不 是 开发 C# 应 用 程序 必需 的 开发 工具 或 集成 开发 环境 (IDE), 但 使 用 它 可 以 使 任务 更 简 
单一 些 。 如 果 愿 意 的 话 ， 可 在 基本 的 文本 编辑 絮 ( 如 常见 的 记事 本 应 用 程序 ) 中 处 理 C# 源 代码 文件 ， 骨 使 
用 .NET Framework 和 .NET Core 中 包含 的 命令 行 编 详 器 把 代码 编 详 到 程序 集中 。 但 是 ， 为 什么 不 使 用 功能 完 
备 的 IDE "We? 


1.3.1 Visual Studio 2017 产品 


Microsoft 提供 了 如 下 几 个 Visual Studio 版 本 : 

e Visual Studio Code 

e Visual Studio Community 

e Visual Studio Professional 

e Visual Studio Enterprise 

H}, Visual Studio Code 和 Community 版 本 可 从 https://www.visualstudio.com/en-us/downloads/download-visual- 
studio-vs $,9* 314. {H Professional 和 Enterprise 版 本 提供 了 一 些 额 外 的 功能 ， 需 要 购买 才能 获得 。 

各 种 Visual Studio 产品 可 以 创建 所 需 的 几乎 所 有 C# 应 用 程序 。Visual Studio Code 是 一 个 简单 但 健壮 的 代码 
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编辑 占 ， 它 运行 在 Windows. Linux 和 iOS 操作 系统 上 。 与 Visual Studio Code 不 同 ，Visual Studio Community 
在 外 观 和 操作 方式 上 类 似 于 Visual Studio Professional 和 Enterprise。 虽 然 Microsoft 在 Visual Studio Community 
中 提供 了 许多 与 Professional 和 Enterprise 版 本 相同 的 功能 ， 但 还 是 缺少 一 些 重要 功能 ， 比 如 深度 调试 功能 和 
代码 优化 工具 。 但 是 缺少 的 特性 并 不 影响 使 用 Community 版 本 来 学 习 本 书 的 各 个 章节 。 本 书 示例 使 用 的 IDE 
版 本 就 是 Visual Studio Community 2017。 


1.3.2 解决 方案 


在 使 用 Visual Studio 开发 应 用 程序 时 ， 可 以 通过 创建 解决 方案 来 完成 。 在 Visual Studio 术语 中 ， 解 决 方案 
不 仅 是 一 个 应 用 程序 ， 它 还 包含 项 目 ， 可 以 是 WPF 项 目 、 云 /Web 应 用 程序 项 目 和 ASP.NET Core A“. fH 
是 ， 解 决 方案 可 以 包 舍 多 个 项 目 ， 这 样 ， 即 使 相关 的 代码 最 终 在 人 硬盘 上 的 多 个 位 置 被 编译 为 多 个 程序 集 ， 也 可 
以 把 它们 组 合 到 一 处 。 

这 是 非常 有 用 的 ， 因 为 它 可 以 处 理 “ 共 享 ” 代 码 (这 些 代 码 放 在 GAC 中 )， 同 时 ， 应 用 程序 也 使 用 这 段 共享 
代码 。 在 使 用 唯一 的 开发 环境 时 ， 调 试 代 码 是 非常 容易 的 ， 因 为 可 在 多 个 代码 模块 中 单 步调 试 指令 。 


1.4 本章 要 点 


to m Zoom 
NET Framework 和 .NET Framework 是 Microsoft 最 新 的 开发 平台 ， 目 前 的 版 本 是 4.7。 它 包括 一 个 公共 类 型 系统 (CTS) 和 一 
NET Core 基础 个 公共 语言 运行 库 (CLR/CoreCLR)。.NET Framework 应 用 程序 使 用 面向 对 象 编 程 (OOP) 的 方法 论 编 写 ， 


通常 包含 托管 代码 。 托 管 代 码 的 内 存 管理 由 .NET 运行 库 处 理 ， 其 中 包括 垃圾 回收 
NET Framework 用 .NET Framework 编写 的 应 用 程序 首先 编译 为 CI。 在 执行 应 用 程序 时 ，JIT 把 CIL 编译 为 本 机 代码 。 


应 用 程序 应 用 程序 编译 后 ， 把 不 同 的 部 分 链接 到 包含 CIL 的 程序 集中 

NET Core 应 用 程序 | NET Core 应 用 程序 的 工作 方式 与 NET Framework 应 用 程序 类 似 ， 但 不 使 用 CLR， 而 使 用 CoreCLR 

NET Standard NET Standard 提供 了 一 个 统一 的 类 库 ， 多 个 NET 平台 (如 .NET Framework. NET Core 和 Xamarin) 都 可 
将 它 作 为 目标 

C# 基 础 C# 是 包含 在 .NET Framework 中 的 一 种 语言 , 它 是 已 有 语言 (如 C++) 的 一 种 演变 , 可 用 于 编写 任意 应 用 程 


序 ， 包 括 Web 应 用 程序 、 跨 平台 应 用 程序 和 时 面 应 用 程序 
集成 开发 环境 (IDE) 可 在 Visual Studio 2017 中 用 C# 编 写 任 意 类 型 的 .NET 应 用 程序 ， 还 可 以 在 免费 的 但 功能 稍 弱 的 
Community 产品 中 用 C# 创 建 .NET 应 用 程序 。IDE 使 用 解决 方案 ， 解 决 方案 可 以 包含 多 个 项 目 


* 
编写 C# 程 序 


REAR: 

e Visual Studio 2017 的 基础 知识 
e 编写 简单 的 控制 台 应 用 程序 
e 编写 简单 的 果 面 应 用 程序 


本 章 源 代码 下 载 : 

本 章 源 代码 可 以 通过 本 书 合作 站 点 Wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapter02 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 独 
命名 。 


第 1 章 已 用 一 定 的 篇 幅 讨论 了 C# 是 什么 ， 以 及 它 是 如 何 适 应 NET Framework 的 ， 现 在 就 该 编写 一 些 代码 
了 。 本 书 主要 使 用 Visual Studio Community 2017， 所 以 首先 介绍 这 个 开发 环境 的 一 些 基 础 知识 。 

Visual Studio 是 一 个 庞大 的 复杂 产品 ， 可 能 会 使 初学 痢 望 而 生长 ， 但 使 用 它 创 建 简单 的 应 用 程序 是 非 芝 容 
昂 的 。 在 本 章 开 始 使 用 Visual Studio 时 ， 不 需要 了 解 许多 知识 ， 融 可 以 编写 C# 代 码 。 本 书 的 后 面 将 介绍 Visual 
Studio 能 执行 的 一 些 更 复杂 的 操作 ， 现 在 仅 介绍 基础 知识 。 

介绍 完 IDE 后 ， 将 创建 两 个 简单 的 应 用 程序 。 现 在 不 必 过 多 地 考虑 代码 ， 只 要 应 用 程序 可 以 运行 即 可 。 在 
这 些 早期 的 示例 中 熟悉 了 应 用 程序 的 创建 过 程 后 ， 不 久 就 会 适应 这 个 过 程 了。 

本 草 将 学 习 创建 两 种 基本 的 应 用 程 厅 类 型 : 控制 台 应 用 程序 和 呆 面 应 用 程 订 。 

下 面 要 创建 的 第 一 个 应 用 程序 是 一 个 简单 的 控制 台 应 用 程序 。 控 制 台 应 用 程序 没有 使 用 图 形 化 的 Windows 
环境 ， 所 以 不 需要 考虑 按钮 、 菜 单 、 用 鼠标 指针 进行 交互 等 ， 而 是 在 命令 行 窗口 中 运行 应 用 程序 ， 用 更 简单 的 
方式 与 其 交互 。 

第 二 个 应 用 程序 是 使 用 Windows Presentation Foundation(WPF) 创 建 的 一 个 时 面 应 用 程序 ， 其 外 观 和 操作 方 
式 对 Windows 用 户 来 说 会 非 铝 熟悉 ， 而 且 该 应 用 程序 创建 起 来 并 不 费力 。 但 所 需 代 码 的 语法 比较 复式 ， 尽 管 在 
许多 情况 下 ， 并 不 需要 考虑 细节 。 

本 书 的 第 开 部 分 、 第 II 部 分 和 第 术 部 分 也 使 用 这 两 种 应 用 程序 类 型 ， 但 开始 时 主要 讨论 控制 台 应 用 程序 。 
在 学 习 C# 语 言 时 , 不 需要 了 解 果 面 应 用 程序 的 其 他 灵活 性 。 控制 台 应 用 程序 的 简单 性 可 以 让 我 们 集中 精力 学 习 
语法 ， 而 不 必 考 虑 应 用 程序 的 外 观 和 操作 方式 。 
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2.1 Visual Studio 2017 开发 环境 


开始 安装 Visual Studio Community 2017 时 ， 系 统 会 给 出 一 个 类 似 于 图 2-1 所 示 的 窗口 提示 。 其 中 包含 
Workloads( 工 作 人 负载 ) 列 表 、Individual components( 单 独 组 件 ) 以 及 一 些 随 核心 编辑 器 安装 的 Language packs( 语 
言 包 )。 

安装 以 下 Workloads 并 单 击 Install 按钮 。 

e Windows—— Universal Windows Platform development 

e Windows——.NET desktop development 

C) .NET Framework 4.7 development tools 

e Web & Cloud ——ASP.NET and web development 

e Web & Cloud—— Azure development 

e 其 他 工具 集 一 一 .NET Core 跨 平台 开发 


Installing — Visual Studio Community 2017 — 15.2 (26430.13) 
Workloads Individual components Language packs 


Windows (3) Summary 
pm E Universal Windows Platform development MET desktop development > Visual Studio core editor 
画面 Create applications for the Universal Windows Platform with C= - Build WPF, Windows Forms and console applications using the 
VB, JavaScnpt, or optionally C++. NET Framework. 


> .NET desktop development 


> .NET Core cross-platform devel... 
a T "T P " 
ec] Desktop development with Cr+ | > Universal Windows Platform de... 
Build classic Windows-based applications using the power of the 
Visual C++ toolset, ATL, and optional features like MFC and 


> ASP.NET and web development 


* Azure development 
Web & Cloud (7) 


ASP.NET and web development a Azure development 
Build web applications using ASP.NET, ASP.NET Core, HTML, Azure SDK, took, and projects for developing cloud apps and 
JavaScript, and C55 creating resources 


Editing, debugging, interactive development and source control for 


Python development (S Made js development 
Python. 


Build scalable network applications using Nodejs, an asynchronous 
event-driven JavaScript runtime. 


@) By continuing, you agree to the license for the 
Visual Studie eciten you selected. We also offer the 
ability bo downloed other software with Wisua 
Studio. This software is licensed separately, as set 
out in the 3rd Party Notices or in its accompanying 

cense. By continuing, you also agree to thore 


rT Oftice/ SharePoint development censes 


Data storage and processing Il; Data science and analytical applications 
Connect, develop and test data solutions using SOL Server, Azure pag Languages and tooling for creating data science applications, 
Data Lake, Hadoop or Azure ML including Python, R and Fe. 


Location 
CAProgram Files (x66)\Microsoft Visual Studio 20 17) Community Install size: 11.67 GB 


Install 


安装 完成 后 ， 在 首次 加 载 Visual Studio 时 ， 会 立即 显示 选项 Sign in to Visual Studio using your Microsoft 
Account(H] Microsoft 账户 注册 Visual Studio)。 注 册 后 ，Visual Studio 设置 就 会 在 设备 上 同步 ， 在 多 个 工作 站 上 
使 用 DE 时 ， 就 不 必 配 置 它 。 如 果 没 有 Microsoft 账户 ， 可 以 创建 一 个 ， 再 使 用 它 注册 。 如 果 不 希 望 注册 ， 就 
单 击 “Not now, maybe later” 链 接 ， 继 续 Visual Studio 的 初始 配置 。 有 了 时 建议 注册 ， 获 得 一 个 开发 人 员 许 可 证 。 

如 果 是 首次 运行 Visual Studio， 则 屏 磊 上 会 显示 一 个 自选 项 列表 。 如 果 用 尸 使 用 过 这 个 开发 环境 的 旧版 本 ， 
则 可 以 在 这 里 做 出 选择 ， 这 些 选 择 会 影响 到 很 多 方面 ， 例 如 窗口 的 布局 、 控 制 侣 窗口 运行 的 方式 等 。 所 以 应 选 
TÉ Visual C#， 人 否则 会 发 现 一 些 地 方 和 本 书 的 描述 不 一 样 。 注 总， 可 用 选项 会 随 看 安 半 Visual Studio 时 选择 的 选 
项 而 变化 ， 但 只 要 选 拌 安装 C#， 这 个 选项 就 是 可 用 的 。 

如 果 不 是 第 一 次 运行 Wisual Studio， 但 以 前 选择 了 夯 一 个 选项 ， 也 不 必 屋 慨 。 为 将 设置 重 置 为 Visual C£, 
只 需要 导入 它们 即 可 。 为 此 , "it; Tools 344 FH] Import and Export Settings 选项 ， 再 选中 Reset all settings 选项 ， 
如 图 2-2 所 示 。 
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bs 
BS Welcome to the Import and Export Settings Wizard 


You can use this wizard to import or export specific categories of settings, or to reset the environment to 
one of the default collections of settings. 


What do you want to do? 


O) Export selected environment settings 
Settings will be saved out to a file so they can later be imported at any time on any machine. 


(O Import selected environment settings 
Import settings from a file to apply them to the environment. 


(&) Reset all settings 
Reset all environment settings to one of the default collections of settings. 


2-2 


单 击 Next 按钮 ， 选 择 是 否 要 在 继续 之 前 保存 已 有 的 设置 。 如 果 对 设置 进行 了 定制 ， 就 保存 设置 ， 人 否则 单 击 
No 按钮 ， 册 次 单 击 Next 按钮 。 在 下 一 个 对 话 杠 中， 选择 Visual C# 选 项 ， 如 图 2-3 所 示 。 可 用 的 选项 可 能 会 
变化 。 


as Choose a Default Collection of Settings 


Which collection of settings do you want to reset to? 


GF General Description: 
D JavaScript Customizes the environment to maximize 
Ü} Visual Basic code editor screen space and improve the 
E} Visual C= visibility of commands specific to 

| C#. Increases productivity with keyboard 
从 Visual C++ shortcuts that are designed to be easy to 
e Web Development learn and use. 
内 Web Development (Code Only) 


2-3 


最 后 单 击 Finish 按钮 ， 然后 单 击 Close 按钮 ， 应 用 设置 。 
Visual Studio 环境 布局 是 完全 可 定制 的 ， 但 默认 设置 很 适合 我 们 。 在 C# Developer Settings 设置 下 ， 其 布局 
如 图 2-4 所 示 。 
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E] Start Page = Microsoft Visual Studio Quick Launch (Corl «CJ n = em x 


File Edit View Project Debug Team Joos Tet Analyze Window Help Benjamin Perkins " 5 


看 -外 局 出 b atah. M- 


B (Start Page + > | - Solution Explorer "Ax 
m 


x 


Get Started Open 


Get code from a "o n central system 
or open something on your local dive. e» Developer News 


Checkout frome 


C Visual Studia Team Services m Cloud Foundry 
Create a private code repo and backlog Tor your project Foun 
F AN EE launched Azure Virtual 
Machirres, | hawe had the pleasure of sehr 
with fantastic community partners and cust... 
NEW Wedinesc me 14, 2017 


Mew to Visual Studio? Check out coding tutorials and sample project4 


Ger training am new frameswnris, Laniguestyes, and Technolgies 


See how easy it is to get started with cloud senmoes M Open Project / Solution 
p 
ma 


Discover ways to extend and customize the IDE J Open Felder 
"h» Open Website 
Demystifying Build Configurations 
= l'm sure everyone is familiar with the Debug 
R e C - nt and Release configurations in most solution 
l i PESE ' temglates in use. It seeme obvious to use the... 
New D | QJ Act NEW Wediresclay. Jurse 14, 20117 
The projects, solutions and folders you open kecally : ae 
appear here. Search project temp ates - Deploying Applications to Azure 
Container Service 
The remote host for Git repositories and other source Recent project templates In this blog post | will shos you haw to setup 
f a dockerized app by 
will appear on the recent list of other continuous delivery of a 
Console App (MET Framewer.. 
devices you've signed in tà. 国 PP using Visual pups | Team Sernces (WETS) to... 
NEW Wedresday. June Td, 2017 
@ ASPNET Core Web Applicati_ xw 
NE] ASPNET Web Application (NL. CA Manage your open source usage and 
security as reported by your CCD 
Bl Console App (MET Core) pipeline 
In the article Manage your apen source usage 
v) AW NE! Lore Web Applcati.. F and secunty in your pipeline, we introduced 
you to WhiteSource and how it can be used... 
£9 ASP.NET Core Web Applicati.. Cs NEW Wednesday, lune 14. 2017 


ASP.NET Core Web Applicsti.. C What does an Agile/DevOps 

organization look like? 

| want to share an experience that highlights 

why I am sa proud of the organization | work 

Create new project in, The experience is expressed in the form... 
NEW Wednesday, lune 14. 2017 


BÓ Class Library GNET Standard) 


More news. 


Satution Explorer Team Explorer 


图 2-4 


所 有 代码 都 显示 在 主 窗 口中 。 在 Visual Studio 启动 时 ， 主 窗口 会 默认 显示 一 个 提供 帮助 信息 的 Start Page. 
主 徐 口 可 以 包含 许多 文档 ， 每 个 文档 部 有 一 个 选项 卡 ， 单 击 文件 名 ， 就 可 以 在 文件 之 间 切 换 。 这 个 窗口 也 具有 
其 他 功能 : 它 可 以 显示 为 项 目 设计 的 GUI、 纯 文本 文件 、HIML 以 及 各 种 内 置 于 Visual Studio 的 工具 。 本 书 将 
陆续 介绍 它们 。 

在 主 窗口 的 上 面 ， 有 工具 栏 和 Visual Studio 菜单 。 这 里 有 几 个 不 同 的 工具 栏 ， 其 功能 包括 : 保存 和 加 载 文 
件 、 生 成 和 运行 项 目 ， 以 及 调试 控件 等 。 在 需要 使 用 这 些 工 具 栏 时 将 会 讨论 它们 。 

下 面 简要 描述 Visual Studio 最 常用 的 主要 功能 : 


单 击 Toolbox 选项 卡 时 ， 就 会 显示 Toolbox 工具 栏 ， 它 提供 了 加 面 应 用 程序 的 用 户 界面 构件 等 条 目 。 男 
一 个 选项 卡 Server Explorer 也 可 以 在 这 里 显示 (通过 View | Server Explorer 亲 单 项 选择 它 )， 它 包含 其 他 
许多 功能 ， 例 如 Azure 订阅 细节 、 数 据 源 访问 、 服 务 器 设置 和 服务 等 。 

Solution Explorer 窗口 显示 当前 加 载 的 解决 方案 的 信息 。 如 第 1 章 所 述 ， 解 决 方案 是 一 个 Visual Studio 
术语 ， 表 示 一 个 或 多 个 项 目 及 其 配置 。Solution Explorer 窗口 显示 了 解决 方案 中 项 目的 各 种 视图 ， 例 如 
项 目 中 包含 了 哪些 文件 ， 这 些 文 件 中 又 包含 了 什么 内 容 。 

Team Explorer 窗口 显示 了 关于 当前 的 Team Foundation Server 或 Team Foundation Service 连接 的 信息 ， 
可 用 于 源 代码 管理 、bug 跟踪 、 目 动 生 成 等 功能 。 但 这 是 一 个 局 级 主题 ， 本 书 不 予 介 绍 。 

Solution Explorer 窗口 之 下 可 以 显示 Properties 窗口 , 该 窗口 没有 显示 在 图 2-4 F. 稍 后 会 看 到 这 个 窗口 ， 
因为 它 只 在 处 理 项 目 时 才 出 现 ( 也 可 以 使 用 View | Properties Window 六 单项 切换 它 )。 这 个 窗口 提供 了 更 
评 细 的 项 目 内 容 视 图 ， 允 许 男 外 配置 单独 元 每。 例如 ， 使 用 这 个 窗口 可 以 改变 加 面 应 用 程序 中 按钮 的 
外 观 。 

A RAE io en nla Vier Bor reelile 
个 窗口 ， 它 显示 了 错误 、 敬 告 和 其 他 与 项 目 有 关 的 信息 。 这 个 窗口 会 持续 不 断 地 更 新 ， 但 其 中 一 些 信 
县 只 有 在 编 详 项 目 时 才 出 现 。 


这 似乎 需要 理解 很 多 东西 ， 但 不 必 担 心 ， 过 不 了 多 久 束 习惯 了 。 下 面 自 先 建立 第 一 个 示例 项 目 ， 它 将 使 用 


上 面 介 绍 的 许多 Visual Studio 70% 
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注意 : 

Visual Studio 还 可 以 显示 许多 其 他 窗口 ， 它 们 都 包含 许多 信息 ， 有 许多 功能 。 其 中 一 些 窗口 与 上 面 提 及 的 
窗口 共享 屏幕 空间 ， 可 以 使 用 选项 卡 切换 它们 或 把 它们 停靠 在 其 他 位 置 。 如 果 有 多 个 显示 器 ， 甚 至 可 以 分 离 它 
们 ， 把 它们 放 到 其 他 显示 器 上 显示 。 本 书 的 后 面 会 介绍 其 中 的 许多 窗口 ， 在 读者 自己 深入 探索 Visual Studio 
环境 时 ， 可 能 还 会 发 现 更 多 的 窗口 。 


22 ”控制 台 应 用 程序 


本 书 将 频 桶 使 用 控制 全 应 用 程序 ， 特 别 是 开始 时 要 使 用 这 类 应 用 程序 ， 所 以 下 面 分 步 演 示 如 何 创 建 一 个 简 
单 的 控制 全 应 用 程序 。 


试 一 试 ”创建 一 个 简单 的 控制 台 应 用 程序 : ConsoleApplication1\Program.cs 
(1) 选择 File | New | Project 菜单 项 ， 创 建 一 个 新 的 控制 台 应 用 程序 项 目 ， 如 图 2-5 所 示 。 


哆 jstart Page - Microsoft Visual Studio 

File Edit View Project Debug Team Tools Test Analyze Window — Help 
New ^ d Project. Ctrl+Shift+N 
Open ^ "5 Web Site... Shift+Alt+N 
start Page ) File.. Ctrl+N 
Close Project From Existing Code... 


M Save All Ctrl+Shift+s 


Source Control 


Account Settings... 


a Exit Alt«FA 


2-5 


(2) 在 显示 窗口 的 左 侧 选择 Visual CH 节点 , 在 中 间 窗 格 中 选择 Console AppC NET Framework) Ji H 2378, 4 
图 2-6 所 示 。 把 Location CAPELLA C:\BeginningCSharp7\Chapter02 (如 果 该 目录 个 人 存在， 会 目 动 创 建 )。Name X 
本 框 中 的 默认 文本 (ConsoleApplication1) 和 其 他 设置 不 变 ， 如 网 2-6 所 示 。 


b Recent NET Framework 4.7 - Sort by: | Default -| aa |! Search (Ctrl +E P- 


nbi x Blank App (Universal Windows) Visual C# = Type: Visual C 
4 Wisual C& ~~ A project for creating a command-line 
Windows Universal n WPF App (NET Framework) isual Cë application 
Windows Classic Desktop ins 
.MET Core 


.NET Standard my 
2 


a 
Windows Forms App (NET Framework) isual C# 


Cloud Console App (MET Core) isual CF 


: 国 
WCF 
b T qe [ca 
Other Languages x Class Library (.NET Standard) isual C# 
- 
Ni 
EN 


Console App (.MET Framework) 


b Other Project Types 
t Online Class Library (NET Framework) isual C# 
Shared Project Visual C# 
ce 
NW Class Library (Legacy Portable) Visual C£ 
LI 


Not finding what you are looking for? 


F ce 
D Class Library (Universal Windows) isual C# 
^ 


Open Visual Studio Installer 


Name: ConsoleApplicatiani 

Location: CABeginning Sharp? Chapterd2, -T Browse.. 

Solution name: ConsoleApplicationt || Create directory for solution 
EB Add to Source Control 
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(3) 单 击 OK 按钮 。 
(4) 初始 化 项 目 后 ， 在 主 窗口 显示 的 文件 中 添加 如 下 代码 行 : 


namespace ConsoleApplicationl 


{ 


class Program 
static void Main(string[] args) 


// Output text to the screen. 
Console .WriteLine ("The first app in Beginning Visual C# 2017!"); 
console .ReadKey () ; 
} 
} 
} 


(5) 选择 Debug | Start Debugging 3391. THUECEEE SUAE] 2-7 所 示 的 结果 。 
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(6) 按 下 任意 键 ， 退 出 应 用 程序 (可 能 需要 首先 单 击 控制 台 窗口 ， 以 激活 它 )。 只 有 像 本 章 前 面 描述 的 那样 应 
用 了 Visual C# Developer Settings， 才 会 显示 图 2-7 所 示 内 容 。 例 如 ， 若 应 用 了 Visual Basic Developer Settings. 
就 会 显示 一 个 空 的 控制 台 窗 口 ， 应 用 程序 的 输出 结果 显示 在 Immediate 窗口 中 。 这 种 情况 下 ,Console.ReadKey0 
代码 也 会 失败 ， 显 示 一 个 错误 。 如 果 遇 到 这 个 问题 , 本 书 中 所 有 示例 的 最 佳 解决 方案 是 应 用 Visual C£ Developer 
Settings， 这 样 读者 看 到 的 结果 才 会 与 书 中 显示 的 相同 。 


示例 说 明 

现在 不 必 仔细 研究 这 个 项 目 中 使 用 的 代码 ， 而 是 关心 如 何 使 用 开发 工具 来 启动 和 运行 代码 。 显 然 ，Visual 
Studio 目 动 完 成 了 许多 工作 ， 简 化 了 编译 和 执行 代码 的 过 程 。 执 行 这 些 简 单 的 步骤 还 有 多 种 方式 。 例 如 ， 创 建 
一 个 新 项 目 可 以 像 前 面 那样 使 用 菜单 项 ， 也 可 以 按 下 Ctl+ShifttN 组 合 键 ， 还 可 以 单 击 工具 栏 上 的 相应 图 标 。 

同样 ， 也 可 以 采用 多 种 方式 编译 和 执行 代码 。 上 例 中 使 用 的 方法 是 选择 Debug | Start Debugging 菜单 项 ， 也 
可 以 按 下 功能 键 (E5), 或 者 使 用 工具 栏 中 的 图 标 。 使 用 Debug | Start Without Debugging 菜 单项 (也 可 以 按 下 CtltF5 
组 合 键 ) 还 可 以 采用 非 调 试 模式 运行 代码 ， 使 用 Build | Build Solution 菜单 项 或 F6 快捷 键 可 以 编译 项 目 但 不 运行 
它 ( 打 开 或 天 闭 调试 功能 )。 注 意 ， 执 行 项 目 但 不 调试 ， 或 者 使 用 工具 栏 中 的 图 标 生成 项 目 ， 只 是 这 些 图 标 在 默认 
青 况 下 没有 显示 在 工具 栏 中 。 编 译 好 代码 后 ， 在 Windows 资源 管理 器 中 运行 生成 的 .exe 文件 ， 就 可 以 执行 代码 。 
也 可 以 在 命令 提示 窗口 中 执行 代码 ， 为 此 ， 应 打开 一 个 命令 提示 窗口 ， 把 目录 改 为 C:\BeginningCSharp7\Chapter02\ 
ConsoleApplicationl\ConsoleApplicationl\bin\Debug\， 键 入 ConsoleApplication1， 并 按 下 回 车 键 。 


注意 : 

在 以 后 的 示例 中 ， 我 们 仅 说 明 “创建 一 个 新 的 控制 台 项 目 ”或 “执行 代码 ”， 用 户 可 以 选用 自己 喜欢 的 方 
式 执行 这 些 步 骤 。 除 非特 别 声明 ， 和 否则 所 有 的 代码 都 应 在 启用 调试 的 情况 下 运行 .另外 ,本 书 中 的 “启动 ”“ 执 
行 ” “运行 ”等 术语 的 含义 是 相同 的 ， 可 互 换 使 用 ， 示 例 后 面 的 讨论 总 是 假定 已 经 退出 了 示例 中 的 应 用 程序 。 

控制 台 应 用 程序 会 在 执行 完毕 后 立即 终止 ， 如 果 直 接 通 过 IDE 运行 它们 ， 就 无 法 看 到 运行 结果 。 为 解决 上 
例 中 的 这 个 问题 ， 使 用 

Console.ReadKey(); 
告诉 代码 在 结束 前 等 待 按键 。 后 面 的 示例 将 多 次 使 用 这 种 技术 。 前 面 创建 了 一 个 项 目 ， 现 在 详细 讨论 开发 环境 
中 的 各 个 组 成 部 分 。 
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2.2.1 Solution Explorer 窗口 


Solution Explorer 窗口 默认 位 于 屏幕 右上 角 。 与 其 他 窗口 一 样 ， 可 把 它 移 到 任何 位 置 ， 或 者 单 击 其 图 钉 图 标 
KE WA A Sheil. Solution Explorer 窗口 与 男 一 个 有 用 的 窗口 Class View 位 于 相同 的 位 置 ， 使 用 View | Class 


View 沫 单项 束 可 以 显示 Class View 窗口 。 图 2-8 显示 了 展开 所 有 节点 的 这 两 个 窗口 (在 窗口 停靠 时 ， 单 击 窗口 
夺 部 的 选项 卡 ， 束 可 以 切换 它们)。 
Solution Explorer 
省 部 -| o-SoOSSOg» s Ü- 


Search Solution Explorer (Ctrl ü) P- <Search> 


& Solution ‘ConsoleApplication1’ (1 project) 一 加 |consoleApplication1 
d ConsoleApplication1 b $9 Project References 
4 J” Properties 4 () ConsoleApplication1 
c= Assemblylinfo.cs 4%, Program 
"E References 4 @ Base Types 
@ Analyzers % Object 
*8 Microsoft.CSharp 
*B System 
E System.Core 
"E System.Data 
"B System.Data.DataSetExtensions 
"E System.Net.Http 
"E System.Xml 
+E System. Xml.Linq 
的 App.config 
4 ¢* Program.cs 
4 "X Program 
©, Main(string[]) : void 


Solution Explorer Class View Team Explorer Solution Explorer | Class View | Team Explorer 


Solution Explorer 窗口 过 示 了 组 成 ConsoleApplicationl 项 目的 文件 ， 包 括 我 们 在 其 中 添加 代码 的 文件 Program_cs、 
男 一 个 代码 文件 AssemblyInfo.es 和 多 个 引用 。 


注意 : 

所 有 C# 代 码 文件 都 使 用 .cs 文件 扩展 名 。 

此 时 不 需要 考虑 AssemblyInfo.cs 文件 ， 它 包含 项 目 中 目前 我 们 不 必 关 心 的 其 他 信息 。 

使 用 这 个 窗口 可 以 改变 主 窗 口中 显示 的 代码 ， 方 法 是 双击 .cs 文件 ， 或 右 击 这 些 文件 并 选择 View Code, Bk 
选中 它们 并 单 击 窗口 项 部 的 工具 栏 按钮 。 还 可 以 对 这 些 文 件 执行 其 他 操作 ， 例 如 ， 重 命名 它们 ， 或 从 项 目 中 删 
除 它们 等 。 在 该 窗口 中 还 可 以 显示 其 他 类 型 的 文件 ， 例 如 ， 项 目 资 源 (资源 是 项 目 使 用 的 文件 ， 这 些 文 件 可 能 
不 是 C# 文 件 ， 如 位 图 图 像 和 声音 文件 等 )。 可 以 通过 同一 界面 处 理 它 们 。 

展开 代码 项 (例如 Program.cs) 可 以 得 看 其 中 包含 的 内 容 。 这 个 代码 结构 概 贤 是 一 个 很 有 帮助 的 工具 ， 可 
用 来 直接 定位 到 代码 文件 中 的 特定 部 分 ， 而 不 必 打 开 代码 文件 并 滚动 到 想 要 处 理 的 部 分 。 

References 项 包含 项 目 中 使 用 的 一 个 NET 库 列 表 ， 这 个 列表 会 在 后 面 介绍 ， 因 为 标准 引用 很 适合 初学 者 使 
FA. Class View 窗口 显示 了 了 项 目的 男 一 种 视图 ， 可 以 用 于 查看 刚才 创建 的 代码 结构 。 本 书后 和 面 将 介绍 代码 结构 ， 
现在 使 用 Solution Explorer 窗口 就 足够 了 了。 单 击 这 些 窗 口中 的 文件 或 其 他 图 标 ，Properties 窗口 的 内 容 就 会 发 生 
相应 变化 ， 如 图 2-9 所 示 。 
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Program.cs File Properties 

SB 无 
Build Action Compile 
Copy to Output Directory Do not copy 
Custom Tool 


Custom Tool Namespace 


File Name Program.cs 


Full Path C’BeginningCSharp/\Chapter02\ConsoleApplication1\ConsoleApplication1\Program.cs 


File Name 
Name of the file or folder. 


图 2-9 


2.22 Properties 窗口 


使 用 View | Properties Window 330 mt n] LAT JF Properties 窗口 .这 个 窗口 显示 了 在 其 上 面 的 窗口 中 所 选 
的 项 的 其 他 信息 。 例 如 ， 选 择 项 目 中 的 Program.cs 文件 ， 束 会 显示 如 图 2-9 所 示 的 窗口 。 这 个 窗口 还 显示 了 其 
他 选中 项 的 信息 ， 例 如 用 户 界 面 组 件 (参见 本 章 的 2.3 “SETA REP” +). 

通常 在 Properties 窗口 中 对 项 目的 改变 会 直接 影响 代码 ， 如 添加 代码 行 ， 或 改变 文件 中 的 内 容 。 对 于 一 些 
项 目 来 说 ， 通 过 这 个 窗口 来 操作 与 手动 修改 代码 所 用 的 时 间 是 相同 的 。 


223 ErrorList 窗口 
当前 Error List 窗口 (View | Error Lisb 没 有 显示 什么 有 趣 的 信息 ， 这 是 因为 应 用 程序 没有 错误 。 但 这 的 确 是 


一 个 非常 有 用 的 窗口 。 下 面 进行 测试 ， 从 上 一 他 添 加 的 代码 中 删除 茶 一 行 末尾 的 分 号 。 稍 后 将 看 到 如 图 2-10 所 
示 的 结果 。 


Entire Solution - € 1 Error | Å O Warnings | (9 0 Messages Build + IntelliSense ~ |Search Error List 


* Code Description Project File Line Suppression St... Y 


DC CS1002 ;expected ConsaleApplication1 Program.cs 15 A Active 


注意 : 


第 3 章 介绍 C 骨 下 法 后 ， 你 就 会 明白 大 多 数 代码 行 的 末尾 必须 有 一 个 分 号 。 


这 个 窗口 有 助 于 根除 代码 中 的 错误 ， 因 为 它 会 跟 踊 我 们 的 工作 , 编译 项 目 。 如 果 双 击 该 窗口 中 显示 的 错误 ， 
光标 就 会 跳 到 源 代码 中 出 错 的 地 方 (如 果 包 含 错误 的 源 文 件 没有 打开 ， 它 将 被 打开 )， 这 样 就 可 以 快速 地 更 正 错 
误 。 代 码 中 有 和 错误 的 行 会 出 现 红色 的 波浪 线 ， 以 便 我 们 快速 浏览 源 代码 ， 找 出 错误 。 

注意 铬 误 位 置 用 一 个 行 号 指定 。 默 认 情 况 下 ， 行 号 不 会 显示 在 Visual Studio MA SaaS, (ASA E 
显示 它 。 为 此 ， 需 要 单 击 Tools | Options XPI, AHP Options 对 话 框 中 的 Line numbers ££. VE EDT 
Text Editor | All Languages | General 类 别 中 。 

在 这 个 对 话 框 中 ， 也 可 以 在 与 各 个 语言 对 应 的 设置 页 面 中 针对 具体 语言 单独 修改 此 设置 。 这 个 对 话 框 中 还 
包含 其 他 许多 有 用 的 选项 ， 本 书后 面 将 使 用 其 中 几 个 选项 。 
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23 ”桌面 应 用 程序 


通常 ， 在 演示 代码 时 ， 将 其 当 作 桌 面 应 用 程序 的 一 部 分 来 运行 ， 要 比 通 过 控制 台 窗口 或 命令 提示 符 来 运行 
更 便于 说 明 。 下 面 用 用 户 界面 构件 组 合 一 个 用 户 界面 。 

下 面 的 示例 介绍 建立 用 户 界面 的 基础 知识 ， 说 明 如 何 启动 和 运行 桌面 应 用 程序 ， 但 并 不 详细 讨论 应 用 程序 
实际 完成 的 工作 。Microsoft 推荐 使 用 WPF 技术 来 创建 桌面 应 用 程序 ， 所 以 本 例 中 使 用 了 WPF。 本 书后 面 会 详 
细 研 究 桌 面 应 用 程序 ， 以 及 WPF 到 底 是 什么 ， 它 到 底 可 以 做 些 什么 。 


试 一 试 ”创建 一 个 简单 的 Windows 应 用 程序 : WpfApplication1\MainWindow.xaml 


#0 WpfApplication1\MainWindow.xaml.cs 


(1) 在 与 之 前 相同 的 位 置 (C:\BeginningeCSharp7\Chapter02) 创 建 一 个 类 型 为 WPF Application 的 新 项 目 ， 其 默 
认 名 称 是 WwWpfApplication1。 如 果 第 一 个 项 目 仍 处 于 打开 状态 ， 吏 应 选择 Create new solution 选项 来 局 动 一 个 新 
的 解决 方案 ， 这 些 设置 如 图 2-11 所 示 。 


NET Framework 4.7 ~ Sortby: Default -| 8 [Ez] Search installed Templates (Ctr P - | 


加 WPF App (.NET Framework) Visual C= - Type: Visual C* 
4 Templates Windows Presentation Foundation client 
4 Visual C$ mi Windows Forms App (NET Framework) Visual C# — 
Windows Classic Desktop 
Web Console J (NET Core Visual C= 
‘NET Core 53 im 
‘NET Standard EN Console App (.NET Framework) Visual C$ 
Cloud 


: ce 
Test = Ne Class Library (.NET Standard) Visual C£ 


P Onli ce 
— Dl Class Librarv (NET Framework) Visual C$ Y 

Name: WpfApplication 

Location: CABeginningCSharp 7 Chapter02^ 7 

Solution: Create new solution " 


Solution name: WpfApplication [w] Create directory for solution 
[ ] Create new Git repository 


图 2-11 


(2) 单 击 OK 按钮 ， 创 建 项 目 。 之 后 应 该 会 看 到 一 个 新 的 分 成 两 个 窗 格 的 选项 卡 。 上 面 的 窗 格 显示 了 一 个 
TAHO, PKA MamWindow， 下 面 的 窗 格 显示 了 一 些 文本 。 这 些 文本 实际 上 束 古 用 来 生成 窗口 的 代码 ， 在 修改 
UI 时 ， 会 看 到 这 些 文本 也 发 生 了 变化 。 

(3) 单 击 屏 医 左上 方 的 Toolbox 选项 卡 ， 然 后 双击 Common WPF Controls 区 域 中 的 Button， 在 窗口 中 添加 
一 个 按钮 。 

(4) 双击 刚才 添加 到 窗口 中 的 按钮 。 

(5) 现在 应 显示 MainWindow.xaml.es 中 的 C# 人 代码。 执行 如 下 修改 (为 简短 起 见 ， 这 里 只 显示 了 文件 中 的 部 
分 代 但 ): 

private void button Click(object sender, RoutedEvetnArgs e) 


MessageBox. Show ("The first desktop app in the book!"); 


(6) 运行 应 用 程序 。 
(7) 单 击 显 示 出 来 的 按钮 ， 打 开 一 个 消息 框 ， 如 图 2-12 所 示 。 
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The first desktop app in the book! 


图 2-12 
(8) 单 击 OK 按钮 。 像 每 个 标准 果 面 应 用 程序 那样 ， 单 击 右 上 角 的 X 图 标 ， 退 出 应 用 程序 。 


示例 说 明 

IDE 又 一 次 上 自动 完成 了 许多 工作 ， 使 我 们 不 费 吹 灰 之 力 就 能 完成 一 个 实用 的 昌 面 应 用 程序 的 创建 。 刚 才 创 
建 的 应 用 程序 与 其 他 窗口 的 行为 方式 相同 一 一 可 以 移动 、 重 新 设置 其 大 小 、 最 小 化 等 。 我 们 不 必 编 写 任何 代码 
来 实现 这 种 功能 。 我 们 添加 的 按钮 也 是 如 此 。 双 击 按钮 ，IDE 就 知道 我 们 想 添加 一 些 代 码 ， 当 运行 应 用 程序 时 ， 
用 户 单 击 该 按钮 ， 就 执行 我 们 已 经 编写 好 的 代码 。 只 要 提供 了 这 段 代 码 ， 就 可 以 得 到 按钮 单 击 的 所 有 功能 。 

当然 ， 桌面 应 用 程序 不 仅 限 于 带 有 按钮 的 普通 窗口 。 如 果 浏 览 从 中 选择 Button 选项 的 工具 箱 ， 就 会 看 到 一 
整套 用 户 界 面 构件 ( 称 为 控件 )， 其 中 一 些 用 户 可 能 很 熟悉 。 本 书 在 其 他 地 方 将 使 用 其 中 的 大 多 数 用 户 界面 构件 ， 
它们 使 用 起 来 都 非常 简单 ， 可 以 省 去 许多 时 间 和 精力 。 

应 用 程序 的 代码 在 MainWindow.xaml.cs 中 ， 这 些 代 码 看 起 来 并 不 比 上 一 节 提 供 的 代码 复杂 多 少 ，Solution 
Explorer 窗口 中 其 他 文件 的 代码 也 不 太 复 杂 。 MainWindow.xaml 中 的 代码 (可 在 添加 按钮 的 拆 分 窗 格 视图 中 看 到 ) 
看 上 去 也 很 简单 。 

这 是 一 段 XAML 代码 。XAML 是 在 WPF 应 用 程序 中 定义 用 户 界 面 的 语言 。 

下 面 仔细 分 析 一 下 在 窗口 中 添加 的 按钮 。 在 MainWindow.xaml 的 顶部 窗 格 ， 单 击 按钮 一 次 选中 它 。 此 时 屏 
幕 右 下 角 的 Properties 窗口 显示 了 按钮 控件 的 属性 (控件 也 有 属性 ， 就 像 上 一 个 示例 中 的 文件 一 样 )。 确保 应 用 
程序 当前 没有 运行 ， 然 后 同 下 演 动 到 Content 属性 ， 该 属性 现在 被 设 为 Button。 将 它 改 设 为 Click Me， 如 图 2-13 
所 示 。 


Name «No Name> 


Type Button 


Arrange by: Category * 
P Brush 
P Layout 
b Text 
b Appearance 
4 Common 
Command 


CommandParameter 


Content Click Me 
IsCancel [| 
IsDefault 


Cursor 


DataContext 


E] 2-13 
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设计 天 中 按钮 上 的 文本 以 及 XAML 代码 也 会 反映 这 种 变化 ， 如 图 2-14 所 示 。 


UST eC ee Main Window.xaml.cs 


| Click Me 


— 
e 
2 
F 
oO 
= 
uw 
Ce 
P 
E 
3 
Lat 
= 
— 
C 
= 
E3 
pw 
p 
adt 
cu 
LA 
|a] 
Cc 
一 
[m] 
Li] 
Di 


112% ~ [A] gms gm [4-| 8] « ; 
O Design tH 回 XAML EEG 
E Window - # wClass = 
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/20@6" 
mlns:local-"clr-namespace:WpfApplicationl" 
mc:Ignorable-"d" 
Title-"MainWindow" Height="350" Width-"525"» 
«Grid» 
«Button Content-"Click Me" HorizontalAlignment-"Left" 
VerticalAlignment="Top" Width="75" Click="Button_Click"/> 


</Grid> 
< /Window> 


2-14 


这 个 按钮 具有 许多 属性 ， 从 按钮 的 颜色 和 大 小 这 些 简单 格式 ， 到 某 些 模糊 设置 (如 数据 绑 定 设置 ， 它 可 以 建 
立 与 数据 的 联系 )， 应 有 尽 有 。 如 上 例 所 述 ， 改 变 属性 通常 会 直接 改变 代码 ， 这 也 不 例外 ， 从 XAML 代码 的 改 
变 中 可 以 看 到 这 一 点 。 但 如 果 切 换 回 MainWindowxamles 的 代码 视图 ， 是 看 不 到 代码 所 发 生 的 变化 的 。 这 是 
因为 WPF 应 用 程序 能 够 保持 应 用 程序 的 设计 (如 按钮 上 的 文本 ) 与 功能 (如 单 击 按钮 后 发 生 的 操作 ) 的 分 离 。 


注意 : 
也 可 以 使 用 Windows Forms 来 创建 昔 面 应 用 程序 。 但 WPF 是 一 种 更 新 的 技术 ， 能 够 以 更 灵活 、 更 强大 的 
方式 来 创建 军 面 应 用 程序 ， 而 且 其 目的 就 是 取代 Windows Forms， 所 以 本 书 中 不 讨论 Windows Forms. 
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t 题 要 A 
Visual Studio 2017 设置 本 书 需要 在 第 一 次 运行 Visual Studio 时 选择 C£ Development Settings 选项 ， 或 者 重 置 它们 
控制 台 应 用 程序 是 简单 的 命令 行 应 用 程序 ， 本 书 主要 用 它 演示 技术 。 在 Visual Studio 中 创建 新 项 目 
控制 台 应 用 程序 时 ， 使 用 Console Application 模板 就 会 创建 新 的 控制 台 应 用 程序 。 要 在 调试 模式 下 运行 项 目 ， 可 使 
Hi Debug | Start Debugging 沫 单项 或 者 按 下 5 功能 键 
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( 续 表 ) 
t 题 要 5 
IDE SD 项 目 内 容 显 示 在 Solution Explorer 窗口 中 。 所 选中 项 的 属性 显示 在 Properties 窗口 中 。 错 误 显 示 在 
Error List 窗口 中 


果 面 应 用 程序 具备 标准 Windows 应 用 程序 的 外 观 和 操作 方式 ， 包 括 最 大 化 、 最 小 化 和 关闭 应 用 程 


果 面 应 用 程序 序 等 大 家 熟悉 的 图 标 。 它 们 是 在 New Project 对 话 框 中 使 用 WPF Application 模板 创建 的 


本 章 内 容 : 

e CH# 的 基本 语法 

e 变量 及 其 用 法 

e 表达 式 及 其 用 法 


本 章 源 代码 可 以 通过 本 书 合 作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter03 文件 夹 中 并 已 根据 本 草 示 例 的 
名 称 单独 命名 。 


要 高 效 地 使 用 CH, 就 一 定 要 理解 创建 计算 机 程序 时 真正 需要 做 些 什么 。 计 算 机 程序 最 基本 的 描述 也 许 是 “一 
系列 处 理 数据 的 操作 ”， 即 使 对 于 最 复杂 的 示例 ， 例 如 Microsoft Office 套装 软件 之 类 的 大 型 多 功能 Windows 应 
用 程序 ， 这 个 论述 也 正确 无 误 。 应 用 程序 的 用 户 虽然 看 不 到 它们 ， 但 这 些 操作 总 是 在 后 台 进 行 。 

为 进一步 解释 这 一 点 ， 考 虑 一 下 计算 机 的 显示 单元 。 我 们 常常 比较 熟悉 屏幕 上 的 内 容 ， 很 难 不 把 它 设想 为 
“移动 的 图 片 >。 但 实际 上 ， 我 们 看 到 的 仅 是 一 些 数据 的 显示 结果 ， 其 最 初 的 形式 是 存储 在 计算 机 内 存 中 的 0 
和 1 数据 流 。 因 此 我 们 在 屏幕 上 执行 的 任何 操作 ， 无 论 是 移动 鼠标 指针 、 单 击 图 标 或 在 字 处 理 器 中 输入 文本 ， 
都 会 改变 内 存 中 的 数据 。 

当然 ， 还 可 以 利用 一 些 较 简 单 的 情形 来 说 明 这 一 点 。 如 果 使 用 计算 器 应 用 程序 ， 就 要 提供 数字 ， 对 这 些 数 
字 执 行 操作 ， 就 像 用 纸 和 笔 计 算数 字 一 样 ， 但 使 用 程序 会 快 得 多 。 

如 果 计 算 机 程序 是 对 数据 执行 操作 ， 则 说 明 我 们 需要 以 某 种 方式 来 存储 数据 ， 需 要 某 些 方法 来 处 理 它们 。 
这 两 种 功能 是 由 变量 和 表达 式 提 供 的 ， 本 章 将 探究 它们 的 一 般 含 义 和 上 有 具体 售 义 。 

在 开始 之 前 ， 应 该 首先 了 解 一 下 C# 编 程 的 基本 语法 ， 因 为 我 们 需要 一 个 环境 来 学 习 和 使 用 CH a PIN 
量 和 表达 式 。 


3.1 C# 的 基本 语法 


C# 代 码 的 外 观 和 操作 方式 与 C++ 和 Java 非常 类 似 。 初 看 起 来 ， 其 语法 可 能 比较 混乱 ， 不 像 亲 些 语言 那样 与 
书面 英语 十 分 接近 。 但 实际 上 ， 在 CHEER, TEAR RVR EIR CERERI], EAH AS Ut N da fl 
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oll} 


于 阅读 的 代码 。 

与 其 他 语言 (如 Python) 的 编 详 器 不 同 ，C# 编 译 器 不 考虑 代码 中 的 空格 、 回 车 和 从 或 制 表 符 (这 些 字 和 从 统称 为 宇 
日 字符 )。 这 样 格 式 化 代码 时 就 有 很 大 的 目 由 度 ， 但 齐 循 条 些 规则 将 有 助 于 提高 代码 的 可 读 性 。 

C# 代 码 由 一 系列 语句 组 成 ， 每 条 语句 都 用 一 个 分 号 结束 。 因 为 空 日 科 急 略 ， 所 以 一 行 可 以 有 多 条 语句 ， 但 
从 可 读 性 的 角度 看 , 通 第 在 分 号 的 后 面 加 上 回 车 符 , 不 在 一 行 中 放置 多 条 语句 。 但 一 条 语句 放 在 多 行 是 可 以 的 (也 
LESSE WL). 

CHE  REGEIBH. AA AaB IGRI — Wr. HERR eH GRE,” Al UI"), TANGER 
HUJER FEX STI), Bd Bis. HERES EA mE aS o 

例如 ， 简 单 的 C# 代 码 块 如 下 所 示 : 


<code line 1, statement 1>; 
<code line 2, statement 2> 
<code line 3, statement 2>; 


} 

其 中 <code line x, statement y> 部 分 并 非 真 正 的 C# 代 码 ， 而 是 用 这 个 文本 作为 C# 语 句 的 占 位 人 秆 。 在 这 段 代 码 
H, 第 2 行 、 第 3 行 代码 是 同一 条 语句 的 一 部 分 ， 因 为 在 第 2 行 的 末尾 没有 分 号 。 缩 进 第 3 行 代码 ， 就 更 容易 
确定 这 是 第 二 行 代码 的 继续 。 

下 面 的 简单 示例 还 使 用 了 缩 进 格式 , bera S C# 代 码 的 可 读 性 。 这 是 标准 做 法 , 实际 上 在 执 认 情况 下 Visual 
Studio 会 目 动 缩 进 代码 。 一 般 情 况 下 ， 每 个 代码 块 都 有 目 己 的 缩 进 级 别 ， 即 它 问 右 缩 进 了 多 少 。 人 代码 块 可 以 互 
相 退 套 ( 即 块 中 可 以 包含 其 他 块 )， 而 被 缺 套 的 块 要 缩 进 得 多 一 些 。 

«code line 1»; 
| 
«code line 2»; 


«code line 3»; 


«code line 4»; 


} 
AJ HU ALANS 77 WET as Re, un EERBARE 3 行 代 码 所 示 。 


在 能 通过 Tools | Options 访问 的 Visual Studio Options 对 话 框 中 ， 显 示 了 Visual Studio 用 于 格式 化 代码 的 规 
则 。 在 Text Editor | C£ | Formatting 节点 的 子 类 别 下 ， 包 含 了 其 中 很 多 规则 。 此 处 的 大 多 数 设 置 都 反映 了 还 没有 
讲述 的 C# 部 分 ， 但 如 果 以 后 要 修改 设置 ,以 更 适合 自己 的 个 性 化 样式 ， 就 可 以 回 过 头 来 看 看 这 些 设置 。 AAD 
中 ， 为 简洁 起 见 ， 所 有 代码 段 都 使 用 默认 设置 来 格式 化 。 


当然 ， 这 种 样式 并 不 是 强制 的 。 但 如 果 不 使 用 它 ， 读 者 在 阅读 本 书 时 会 很 快 陶 入 迷 。 范 之 中 。 

fr C# 代 码 中 ， 男 一 种 常见 的 语句 是 注释 。 注 释 并 非 严 格 意 义 上 的 C# 人 代码 ， 但 代码 最 好 有 注释 。 注 释 的 作 
AAA AAA: 给 代码 添加 摘 述 性 文本 (用 英语 、 法 语 、 德 语 等 )， 编 详 吉 会 忽略 这 些 内 容 。 在 开始 处 理 元 长 的 代 
码 段 时 ， 注 释 可 用 于 为 正在 进行 的 工作 添加 提示 ， 例 如 “这 行 代码 要 求 用 户 输 入 一 个 数字 ”或 “这 段 代 码 由 
Bob 编写 ”。 

C# 洪 加 注释 的 方式 有 两 种 。 可 以 在 注释 的 开头 和 结尾 放置 标记 ， 也 可 以 使 用 一 个 标记 ， 其 含义 是 “这 行 代 
码 的 其 余部 分 是 注释 ”。 在 C# 闹 译 右 忽略 回 车 符 的 规则 中 ， 后 者 是 一 个 例外 ， 但 这 是 一 种 特殊 情况 。 

要 使 用 第 一 种 方式 标记 注释 ， 可 在 注释 开 尖 加 上 * 字 和 从， 在 末尾 加 上 */ 字 行 。 这 些 注释 从 号 可 以 在 单独 一 
行 上 ， 也 可 以 在 不 同 的 行 上 ， 注 释 答 号 之 则 的 所 有 内 容 都 是 注释 。 注 释 中 唯一 不 能 输入 的 是 *¥， 因 为 它 会 补 看 
成 注释 结束 标记 。 所 以 下 面 的 语句 是 正确 的 ; 


/* This is a comment */ 
/* And so. a . 
. is this! */ 


但 以 下 语句 会 产生 错误 : 
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/* Comments often end with "*/" characters */ 

注释 结束 符号 后 的 内 容 ("*/" 后 面 的 字符 ) 会 被 当 作 C# 代 码 ， 因 此 产生 错误 。 

另 一 种 添加 注释 的 方式 是 用 /开始 一 个 注释 ， 在 其 后 可 以 编写 任何 内 容 ， 只 要 这 些 内 容 在 一 行 上 即 可 。 下 
面 的 语句 是 正确 的 : 

// This is a different sort of comment. 

(A Pr gie) AM, HARITASI C# 代 码 : 


// So is this, 
but this bit isn't. 


这 类 注释 可 用 于 语句 的 说 明文 档 ， 因 为 它们 都 放 在 一 行 上 : 

<A statement>; // Explanation of statement 

前 面 讲 过 ， 有 两 种 给 C# 代 码 添 加 注释 的 方式 。 但 在 C# 中 ,， 还 有 第 三 类 注释 , 严格 地 说 ， 这 是 /语法 的 扩展 。 
它们 都 是 单行 注释 ， 用 三 个 /符号 来 开头 ， 而 不 是 两 个 。 

/// A special comment 

EEU F Saher 2m EI wR ERE RE. (AB) DAC Visual Studio， 在 编 详 项 目 时 ， 所 
取 这 些 注释 后 面 的 文本 ， 创 建 一 个 特殊 格式 的 文本 文件 ， 该 文件 可 用 于 创建 文档 。 为 了 创建 文档 ， 注 释 必 须 遵 
(i XML 文档 的 规则 , 详 见 https://docs.microsoft.com/en-us/dotnet/csharp/programming-guide/xmldoc/xml-documentation- 
comments。 本 书 不 讨论 这 个 主题 ， 但 这 是 很 值得 探讨 的 内 容 ， 如 果 读 者 有 时 间 ， 建 议 学 习 掌握 。 

特别 要 注意 的 一 点 是 ，C# 代 码 是 区 分 大 小 写 的。 与 其 他 语言 不 同 ， 必 须 使 用 正确 的 大 小 写 形式 输入 代码 ， 
因为 简单 地 用 大 写字 母 代 蔡 小 写字 母 会 中 断 项 目的 编译 。 看 看 下 面 这 行 代 码 ， 它 曾 在 第 2 章 中 使 用 : 

Console.WriteLine("The first app in Beginning C# Programming!"); 

C# 编 译 器 能 理解 这 行 代 码 ， 因 为 Console.WriteLineO 命 令 的 大 小 写 形式 是 正确 的 。 但 是 ， 下 面 的 语句 都 不 
能 工作 : 

console .WriteLine ("The first app in Beginning C# Programming!"); 


CONSOLE .WRITELINE ("The first app in Beginning C# Programming!"); 
Console.Writeline ("The first app in Beginning C£ Programming!"); 


这 里 使 用 的 大 小 与 形式 是 错误 的 ， 所 以 CHAR VERAS AIDE BUTS A S E, Visual Studio 在 代码 的 键入 
方面 提供 了 许多 帮助 ， 在 大 多 数 情况 下 ， 它 都 知道 我 们 要 做 什么 。 在 键入 代码 的 过 程 中 ，Visual Studio 会 推荐 
用 户 可 能 要 使 用 的 命令 ， 并 尽 可 能 地 纠正 大 小 写 问 题 。 


3.2 “C# 控 制 台 应 用 程序 的 基本 结构 


下 面 看 看 第 2 童 的 控制 台 应 用 程序 示例 (ConsoleApplication1)， 并 研究 一 下 它 的 结构 。 其 代码 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 
namespace ConsoleApplicationl 

{ 


class Program 


static void Main(string[] args) 

{ 
// Output text to the screen. 
Console.WriteLine("The first app in Beginning C# Programming!"); 
Console.ReadKey (); 

} 

} 
} 


EIRE AEE. ET WBHEIIBPRIBIACUSOX AA PAS. i ERARE AE. 
目前 看 来 ， 这 段 代 码 中 最 重要 的 部 分 如 下 所 示 : 
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oll} 


~ void Main(string[] args) 

| // Output text to the screen. 

Console.WriteLine("The first app in Beginning C£ Programming!"); 
Console.ReadKey(); 

} 

当 运 行 控制 台 应 用 程序 时 ， 融 会 执行 这 段 代码 ， 更 确切 地 讲 ， 是 运行 花 括 号 中 的 代码 其 。 如 前 所 述 ， 注 释 
行 不 做 任何 事情 ， 包 含 它 们 上 只 为 了 保持 代码 的 清晰 。 其 他 两 行 代码 在 控制 侣 窗口 中 输出 一 些 文 本 ， 并 等 待 一 个 
啊 应 。 但 目前 我 们 还 不 需要 关心 它 的 具体 机 制 。 

这 里 要 注意 一 下 如 何 实现 第 2 章 介 绍 的 代码 大 网 功能 (虽然 在 第 2 章 中 介绍 的 是 Windows 应 用 程序 的 代码 
大 网 功 能 )， 因 为 它 是 一 个 非常 有 用 的 特性 。 要 实现 该 功能 ， 需 要 使 用 扫 egion 和 #endregion 关键 字 来 定义 可 以 展 
开 和 折 登 的 代码 区 域 的 开头 和 结尾 。 例 如 ， 可 以 修改 针对 ConsoleApplication1 生成 的 代码 ， 如 下 所 示 : 

#region Using directives 

using System; 

using System.Collections.Generic; 

using System.Ling; 

using System.Text; 


using System. Threading.Tasks; 


#endregion 
这 样 束 可 以 把 这 些 代 码 行 折 登 为 一 行 ， 以 后 要 碍 看 其 细节 时 ， 可 以 再 次 展开 它 。 这 里 包含 的 using 语句 和 
其 下 的 namespace 语句 将 在 本 章 后 面子 以 解释 。 


注意 : 

以 # 开 头 的 任意 关键 字 实际 上 是 一 个 预 处 理 指令 ， 严 格 地 说 并 不 是 C# 关 键 字 。 除 了 这 里 描述 的 村 egion 和 
#endregion 关键 字 外 ， 其 他 关键 字 都 相当 复杂 ， 也 都 有 专门 的 用 途 。 所 以 在 阅读 完 本 书后 ， 读 者 可 以 再 去 研究 
这 个 主题 。 相 关 更 多 内 容 ， 可 访问 https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/preprocessor- 
directives/。 


现在 不 必 考 虑 示例 中 的 其 他 代码 ,因为 本 书 前 几 间 仅 解 释 C# 的 基本 语法 ,至 于 应 用 程序 进行 Console.WriteLine( 
调用 的 具体 方式 ， 则 不 在 我 们 的 考虑 之 列 。 以 后 会 曾 述 这 行 代码 的 草 要 性 。 
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如 前 所 述 ， 变 量 关 系 到 数据 的 存储 。 实 际 上 ， 可 以 把 计 复 机 内 存 中 的 变量 看 成 末了 于 上 的 盒 于 。 在 这 些 例 于 
中 ， 可 以 放 入 一 些 东 西 ， 册 把 它们 取出 来 ， 或 者 只 是 看 看 盒子 里 是 否 有 东西 。 变 量 也 是 这 样 ， 数 据 可 放 在 变量 
中 ， 可 以 根据 需要 从 变量 中 取出 数据 或 得 看 它们 。 

尽管 计算 机 中 的 所 有 数据 事实 上 都 是 相同 的 东西 (一 组 0 和 1), 但 变量 有 不 同 的 内 涵 ， 称 为 类 型 。 下 面 再 用 
MPRA, BANANA, EAA REPENS B. BITRE RSNA, A 
同 关 型 的 数据 需要 用 不 同 的 方法 来 处 理 。 将 变量 限定 为 不 同 的 类 型 可 以 避免 混 消 。 例 如 ， 组 成 数字 图 片 的 0 和 
1 序列 与 组 成 音频 文件 的 0 和 1 序列 ， 其 处 理 方式 是 不 同 的 。 

要 使 用 变量 ， 需 要 先 声 明 它 们 ， 即 给 变量 指定 名 称 和 关 型 。 声 明 变 量 后， 就 可 以 把 它们 用 作 存 储 单元 ， 存 
储 所 声明 的 数据 类 型 的 数据 。 

声明 变量 的 C# 语 法 仅 指 定 关 型 和 变量 名 ， 如 下 所 未: 

<type> <name>; 

QAM ACP AAI eee, TRACE, {ACI Pease a ROT TA lela, PT Ae TX 
METER. b. (EAA AIEEE Set ZS EAER Fin PE aie zh UU LIK “ME VK o 


3.3.1 简单 类 型 
简单 类 型 就 是 组 成 应 用 程序 中 基本 构件 的 类 型 ， 例 如 ， 数 值 和 布尔 值 (true 或 false)。 与 复杂 类 型 不 同 ， 简 
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单 类 型 没有 子 类 型 或 特性 。 大 多 数 简单 类 型 都 是 存储 数值 的 ， 初 看 起 来 有 点 奇怪 ， 使 用 一 种 类 型 来 存储 数值 不 
可 以 吗 ? 


有 很 多 数值 类 型 是 因为 在 计算 机 内 存 中 ， 把 数字 作为 一 系列 的 0 和 1 来 存储 。 对 于 整数 值 ， 用 一 定 的 位 ( 单 
个 数字 , 可 以 是 0 或 1) 来 存储 ， 用 二 进 制 格式 来 表示 。 以 N 位 来 存储 的 变量 可 以 表示 任何 介 于 0 到 (2 -1) 之 间 
的 数 。 大 于 这 个 值 的 数 因 为 太 大 ， 所 以 无 法 存储 在 这 个 变量 中 。 

例如 ， 有 一 个 变量 存储 了 两 位 ， 在 整数 和 表示 该 整数 的 位 之 间 的 上 映射 应 如 下 所 示 : 
ou 

2 10 

3 = 11 

如 果 要 存储 更 多 数字 ， 就 需要 更 多 的 位 (例如 ，3 位 可 以 存储 0 到 7 的 数 )。 

这 样 得 到 的 结论 是 要 存储 每 个 可 以 想象 得 到 的 数 ， 就 需要 非常 多 的 位 ， 这 并 不 适合 PC。 即 使 可 以 用 足够 多 
的 位 来 表示 每 一 个 数 ， 用 这 么 多 的 位 存储 一 个 表示 范围 很 小 的 变量 (例如 0 到 10) 的 效率 非 营 低下， 因为 存储 丹 
被 浪费 了 。 其 实 表示 0 到 10 之 间 的 数 ，4 位 就 是 够 了 了， 这样 就 可 以 用 相同 的 内 存 空间 存储 这 个 范围 内 的 更 多 

相反 ， 许 多 不 同 的 整数 类 型 可 用 于 存储 不 同和 范围 的 数值 ， 占 用 不 同 的 内 存 空 间 (至 多 64 位 )， 这 些 类 型 如 表 
3-1 所 示 。 


0 


表 3-1 整数 类 型 
类 om Wd d 
sbyte System.SByte jr - 128 和 127 之 间 的 整数 


byte 介 于 0 和 255 之 间 的 整数 

short 介 于 -32768 和 32 767 之 间 的 整数 

ushort 介 于 0 和 65 535 之 间 的 整数 

int 介 于 -2 147 483 648 和 2 147 483 647 之 间 的 整数 
uint 介 于 0 和 4294 967 295 之 间 的 整数 


long System Int64 介 于 - 9 223 372 036 854 775 808 和 9 223 372 036 854 775 807 之 间 的 整数 


ulong System.UInt64 介 于 0 和 18 446 744 073 709 551 615 之 间 的 整数 
注意 : 


这 些 类 型 中 的 每 一 种 都 利用 了 .NET Framework 中 定义 的 标准 类 型 。 如 第 1 章 所 述 , 使 用 标准 类 型 可 以 在 语言 
之 间 交 互 操作 。 在 C# 中 这 些 类 型 的 名 称 是 Framework 中 定义 的 类 型 的 别名 ， 表 3-1 列 出 了 这 些 类 型 在 NET 
Framework 库 中 的 名 称 。 


一 些 变量 名 称 前 面 的 “u ”是 unsigned 的 缩写 , 表示 不 能 在 这 些 类 型 的 变量 中 存储 负数 , 参见 表 3-1 PHI“ 
许 的 值 ”一 列 。 

当然 ， 还 需要 存储 浮 点 数 ， 它 们 不 是 整数 。 可 以 使 用 的 浮 点 数 变 量 类 型 有 3 种 : float, double 和 decimal. 
前 两 种 可 以 用 士 mx2- 的 形式 存储 浮 点 数 ， 其 中 mA 的 值 因 类 型 而 异 。decimal 使 用 另 一 种 形式 : 3 mx10*. 
这 3 种 类 型 、 它 们 所 允许 的 m 和 e 的 值 ， 以 及 它们 在 实数 中 的 上 下 限 如 表 3-2 所 示 。 


表 3-2 浮 点 类 型 


| | | 最 小 值 最 大 值 最 小 值 最 大 值 最 小 值 最 大 值 
double System .Double -1075 50 x 10" 17 X 1p** 
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除数 值 类 型 外 ， 男 外 还 有 3 种 简单 类 型 ， 如 表 3-3 所 示 。 


表 3-3 ”文本 和 布尔 类 型 


类 型 » g jt Yr R9 (B 
char 一 个 Unicode 5-4, ffi 0 和 65 535 之 间 的 整数 
bool System.Boolean 布尔 值 ， true 或 false 


in ez 


注意 组 成 string 的 字符 数量 没有 上 限 ， 因 为 它 可 以 使 用 可 变 大 小 的 内 存 。 

布尔 类 型 bool 是 C# 中 最 常用 的 一 种 变量 类 型 ， 类 似 的 类 型 在 其 他 语言 的 代码 中 非常 丰富 。 当 编写 应 用 程 
序 的 逻辑 流程 时 , 一 个 可 以 是 true 或 false 的 变量 有 非常 重要 的 分 支 作 用 ,例如 , 考虑 一 下 有 多 少 问 题 可 以 用 true 
或 false( 或 yes 和 no) 来 回答 。 执 行 变 量 值 之 间 的 比较 或 检查 输入 的 有 效 性 就 是 后 和 面 使 用 布尔 变量 的 两 个 编程 
示例 。 

介绍 了 这 些 类 型 后 ， 下 面 用 一 个 简短 示例 来 声明 和 使 用 它们 。 在 下 例 中 ， 要 使 用 一 些 简单 的 代码 来 声明 两 
个 变 量 ， 给 它们 赋值 ， 再 输出 这 些 值 。 


试 一 试 ” 使 用 简单 类 型 的 变量 : ChO3Ex01\Program.cs 


(1) 在 目录 CABeginningCSharp7\Chapter03 下 创建 一 个 新 的 控制 台 应 用 程序 Ch03Ex01。 
(2) 在 Program.cs 中 添加 如 下 代码 : 


static void Main(string[] args) 

{ 
int myInteger; 
string myString; 
myInteger = 17; 
myString = "\"myInteger\" is"; 
Console.WriteLine($"(myString) {myInteger}") ; 
Console .ReadKey () ; 

} 


(3) 运行 代码 ， 结 果 如 图 3-1 所 示 。 


示例 说 明 

我 们 添加 的 代码 完成 了 以 下 3 项 任务 : 
e 声明 两 个 变量 ; 

e 给 这 两 个 变量 赋值 ; 

e 将 这 两 个 变量 的 值 输出 到 控制 台 。 
变量 声明 使 用 下 述 代码 : 


int myInteger; 
string myString; 


第 一 行 声 明 一 个 类 型 为 int 的 变量 myInteger， 第 二 行 声明 一 个 类 型 为 string 的 变量 myString。 


注意 : 


变量 的 命名 是 有 限制 的 ， 不 能 使 用 任意 字符 序列 。3.3.2 节 “变量 的 命名 ”将 介绍 变量 的 命名 规则 .。 
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接 下 来 的 两 行 代码 为 变量 赋值 : 


myInteger = 17; 
myString = "\"myInteger\" is"; 


使 用 三 赋值 运算 符 ( 在 本 章 的 3.4 节 “ 表 达 式 ”中 将 详细 介绍 ) 给 变量 分 配 两 个 固定 的 值 (在 代码 中 称 为 字面 
值 )。 把 整数 值 17 赋 给 myInteger， 把 字符 串 "myInteger " is( 包 括 引号 ) 赋 给 myString。 


"myInteger" is 


DAP UG Ss FF BE, OAS SET TREK. DUE, RE RA SAMS S, 
BUR. UU HERR NRE FT NEUE MP) RSE 1. AAEE RAS MOSS: 

myString = "\"myInteger\" is"; 

如 条 不 使 用 这 些 转 义 序列 ， 而 输入 如 下 代码 : 

myString = ""myInteger" is"; 

融会 出 现 编 详 错误 。 

注意 给 字符 串 赋予 字面 值 时 ， 必 须 小 心 换 行 一 一 C# 纲 详 绑 会 拒绝 分 布 在 多 行 上 的 字符 串 字 面值 。 右 要 添加 
一 个 换行 符 ， 可 在 字符 串 中 使 用 换行 符 的 转 义 序列 ， 即 m。 例 如 ， 赋 值 语句 : 

myString = "This string has a\nline break."; 

会 在 控制 台 视 图 中 将 字符 串 显示 为 两 行 ， 如 下 所 示 : 


This string has a 
line break. 


PA PAAR ET BORAT ATS» Ja E THEBIS Es E PIA) LA BoA S AHR, 
ATM EAS BAT PS, BU PEACHY BORAT \\ 6 
下 面 继续 解释 代码 ， 还 有 一 行 没 有 说 明 : 


Console.WriteLine ($"{myString} {myInteger}"); 


这 是 C# 6 中 的 一 个 新 功能 ， 称 为 字符 串 插 入 (String Interpolation)， 它 看 起 来 类 似 于 第 一 个 示例 中 把 文本 写 
到 控制 合 的 简单 方法 ， 但 本 例 指 定 了 变量 。 这 里 不 详细 讨论 这 行 代码 ， 只 需要 知道 这 是 本 书 第 I 部 分 用 于 给 控 
制 台 窗口 输出 文本 的 一 种 技巧 。 

在 后 面 的 示例 中 ， 就 使 用 这 种 给 控制 台 输 出 文本 的 方式 来 显示 代码 的 输出 结果 。 最 后 一 行 代码 在 前 和 面 的 示 
例 中 也 出 现 过 ， 用 于 在 程序 结束 前 等 竺 用 户 输入 内 容 : 


Console.ReadKey (); 


这 里 不 详细 探讨 这 行 代 码 ， 但 后 面 的 示例 会 草 弟 用 到 它 。 现 在 只 需要 知道 ， 它 暂停 代码 的 执行 ， 直 到 用 户 
fk PORT SE. 


33.2 ”变量 的 命名 


如 上 一 节 所 述 ， 不 能 把 任意 序列 的 字符 作为 变量 名 。 但 没 必要 为 此 感到 担心 ， 因 为 这 种 命名 系统 仍 是 非常 
灵活 的 。 

基本 的 变量 命名 规则 如 下 : 

。 变量 名 的 第 一 个 字符 必须 是 字母 、 下 画 线 ( ) 或 @。 

。 其 后 的 字符 可 以 是 字母 、 下 画 线 或 数字 。 

另外 ， 有 一 些 关键 字 对 于 C# 编 译 器 而 言 具 有 特定 的 含义 ， 例 如 前 面 出 现 的 using 和 namespace 关键 字 。 如 
果 错 误 地 使 用 其 中 一 个 关键 字 ， 编 译 器 会 产生 一 个 错误 ， 我 们 马上 就 会 知道 出 错 了 ， 所 以 不 必 担 心 。 
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例如 ， 下 面 的 变量 名 是 正确 的 : 


myBigVar 
VARI 
test 


下 列 变量 名 有 误 : 
9S9BottlesOfBeer 


namespace 
It's-All-Over 


3.8.3 字面 值 

在 前 面 的 示例 中 ， 有 两 个 字面 值 示例 : 整数 (17) 和 字符 串 (\myImteger' is")。 其 他 变量 类 型 也 有 相关 的 字面 
B. WK 3-4 所 示 。 其 中 有 许多 涉及 后 组 ， 即 在 字面 值 的 后 面 浴 加 一 些 字 符 来 指定 想 要 的 闫 型。 一 些 字 面值 有 
多 种 类 型 ， 在 编译 时 由 编 详 右 根据 它们 的 上 下 文 确定 其 类 型 (同样 见 表 3-4)。 


表 3-4 字面 值 

x m zB et 
= wa 
ulong ul uL. Ul UL. lu, IU. Lu Kj LU 100UL 
float f ak F 1.5F 
decimal m 或 M 1.5M 
= Co 
string FIE "a...a"， 可 以 包含 转 义 序列 


1. 二 进 制 子 面值 与 数字 分 隅 符 

无 论 编程 语法 有 多 复杂 ， 计 算 机 部 只 能 以 两 种 状态 一 一 0 和 1 来 工作 ， 这 就 是 人 们 所 熟知 的 二 进 制 (基数 为 
2)。 如 果 愿 意 ， 可 以 将 所 有 的 程序 都 编码 为 由 1 和 0 组 成 的 序列 ， 之 后 再 运行 程序 。 虽 然 这 种 方式 既 不 实用 也 
不 值得 推荐 ， 但 这 样 做 可 以 将 减轻 解释 磺 的 负担 ， 让 解释 需 不 用 再 从 C#、 十 进 制 (基数 为 10)、 八 进 制 (基数 为 
8) 或 十 六 进 制 (基数 为 16) 等 对 程序 进行 转换 。 这 样 做 并 没有 多 大 好 处 ， 所 以 必须 认识 到 只 有 在 非常 特殊 的 情况 
下 才 会 用 到 二 进 制 表示 法 。 例 如 ， 可 能 需要 以 二 进 制 、 十 六 进 制 或 ASCI 但 的 形式 将 一 些 值 传递 给 第 三 方 的 代 
码 包 。 大 部 分 情况 下 ， 除 非 确实 需要 二 进 制 字面 值 ， 含 则 还 是 应 该 使 用 C# 等 编程 语言 来 编写 代码 。 

深入 理解 了 有 关 半 字 节 、 位 、 字 节 、 和 他 从 、 字 、 二 进 制 、 八 进 制 、 十 六 进 制 等 字面 值 的 拉 术 知识 和 历史 背 
景 ， 才 能 够 深入 理解 何 时 、 在 什么 地 方 、 如 何以 及 为 什么 使 用 这 些 字 和 面值。 我 们 不 会 深入 探讨 “为 什么 使 用 ” 
这 个 历史 问题 ， 也 不 会 深入 探讨 “如 何 使 用 ”这 个 专业 问题 。 现 在 明白 下 面 这 样 的 问题 束 已 经 足够 ， 例 如， 可 
以 将 二 进 制 学 面值 作为 一 种 优雅 方法 ， 在 进行 模式 匹配 和 比较 时 将 值 存储 为 第 量 ， 还 可 以 用 来 实现 位 掩 码 。 如 
下 面 代码 行 中 对 二 进 制 和 十 六 进 制 所 做 的 对 比 所 示 ， 可 以 发 现 ， 二 进 制 数字 从 右 往 左 循环 移动 一 位 。 十 六 进 制 
值 不 存在 模式 ， 所 以 很 难 快速 确定 代码 的 意图 。 


int[] binaryPhases = [ 0b00110001, 0b01100010, 0b11000100, 0b10001001 |]; 
int[] hexPhases = [ 0x31, Ox62, OxC4, 0X89 ]; 


了 解 这 些 背景 知识 后 , 我 们 并 不 会 深入 探讨 模式 匹配 和 位 掩 码 。 本 节 剩 余部 分 将 重点 介绍 C#7 中 的 二 进 制 
字面 值 和 数字 分 隔 符 。 在 阅读 本 书 并 有 了 更 多 的 编码 经 验 后 ， 你 可 以 自行 阅读 有 关 二 进 制 模式 匹配 和 位 掩 码 的 
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更 多 信息 ， 增 加 自己 的 知识 储备 。 
为 了 更 好 地 理解 C# 7 的 二 进 制 字面 值 ， 以 下 面 的 代码 为 例 : 
int[] numbers = [ 1, 2, 4, 8, 16 ]; 
在 C#7 中 ， 可 以 直接 以 二 进 制 的 形式 同 numbers 数组 添加 仁 ， 如 下 所 示 : 


int[] numbers = [ 0b0001, 0b0010, 0b00100, 0b0001000, 0b00010000 ]; 


正如 十 六 进 制 值 以 前 级 Ox Fes, Sa PERSE LL Ob 开头 的 任何 值 都 识别 为 二 进 制 值 ， 并 按照 二 进 制 值 进行 
处 理 。 能 够 想到 ， 较 大 数 的 二 进 制 值 会 非常 长 ， 当 手动 输入 时 特别 容易 犯错 。 例 如 数字 128 的 二 进 制 值 为 
10000000—— BI 1 后 面 要 跟 7 个 0。 对 于 这 种 情况 ，C# 7 中 的 新 特性 数字 分 隔 符 就 可 以 派 上 用 场 。 例 如， 下 面 
的 代码 : 


int[] numbers = [ 32, 64, 128 ]; 
int[] numbers = [ 0b0010 0000, 0b0100 0000, 0b1000 0000 ]; 


可 以 看 出 ， 将 二 进 制 字面 值 分 隅 成 数字 组 有 助 于 增强 代码 的 可 读 性 ， 便 于 代码 的 管理 。 数 字 分 隅 符 不 只 适 
用 于 二 进 制 值 ， 也 可 以 用 于 十 进 制 、 浮 点 数 和 双 精 度数 。 下 面 的 代码 在 表示 Pi 的 值 时 ， 每 三 位 使 用 了 一 个 分 隅 
符 。 使 用 数字 分 隔 符 的 主要 目的 束 是 使 代码 更 易 读 。 


public const double Pi = 3.141 592 653 589 793 238 462 643 383 279 502; 


2. 字符 串 字 面值 
本 章 前 面 介 绍 了 几 个 可 在 字符 串 字面 值 中 使 用 的 转 义 序列 ， 表 3-5 是 这 些 转 义 序列 的 完整 列表 ， 以 便 以 后 


表 3-5 字符 串 字面 值 的 转 义 序列 


— —Ü 


表 3-5 中 的 “字符 的 Unicode 值 ” 列 是 字符 在 Unicode 字符 集中 的 十 六 进 制 值 。 除 了 上 面 这 些 ， 还 可 以 使 
用 Unicode 转 义 序列 指定 其 他 任何 Unicode 字符 ， 该 转 义 序列 包括 标准 的 \ 字 符 ， 后 跟 一 个 u 和 一 个 4 位 十 六 进 
制 值 (例如 ， 表 3-5 中 x 后 面 的 4 位 数字 )。 

下 面 的 字符 串 是 等 价 的 : 


"Benjamin\'s string." 
"Benjamin\u0027s string." 


TIA, Unicode 转 义 序列 还 有 更 多 用 途 。 

也 可 以 一 字 不 变 地 指定 字符 串 ， 即 两 个 双 引 号 之 间 的 所 有 字符 都 包含 在 字符 串 中 ， 包 括 行 末 字 符 和 原本 需 
要 转 义 的 字符 。 唯 一 的 例外 是 必须 指定 双 引 号 字符 的 转 义 序列 ， 以 免 结束 字符 串 。 这 种 方法 需要 在 字符 串 之 前 
加 一 个 @ 字 符 : 
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Di} 


@"Verbatim string literal." 
tu] DAFA Ey SR EI EI BS (AR IEP EOF: 
@"A short list: 


item 1 
item 2" 


—"EANAEUWI ENSE EXE FE A, ALACRA RRL RET SL 
DAVEE FFF BE AAS AL, fil OU: 

"C:\\Temp\\MyDir\\MyFile.doc" 

MA S—-FARNSAB FHA, RENE ie. RRNA SESS or: 


@"C: \Temp\MyDir\MyFile.doc" 


注意 : 
从 本 书 的 后 面 可 以 看 出 ， 字 符 串 是 引用 类 型 ， 而 本 章 中 的 其 他 类 型 都 是 值 类 型 。 所 以 ， 字 符 串 也 可 以 被 赋 
T null 值 ， 表 示 字 符 串 变量 不 引用 字符 串 (或 其 他 任何 东西 )。 


3.4 FIAT 


CHET VE STMT ARAN. FUSS EES RIN, ENA FED Sie STA TT 
起 来 ， 束 可 以 创建 表达 式 ， 它 是 计算 的 基本 构件 。 

运 鼻 符 范围 广泛 ， 有 简单 的 ， 也 有 非 章 复 杂 的 ， 其 中 一 些 可 能 只 在 数学 应 用 程序 中 使 用 。 简 单 的 操作 包 丘 
所 有 的 基本 数学 操作 ， 例 如 + 运算 符 是 把 两 个 操作 数 加 在 一 起 ， 而 复杂 的 操作 包括 通过 变量 内 容 的 二 进 制 表示 
来 处 理 它们 。 还 有 专门 用 于 处 理 布尔 值 的 逻辑 运算 全， 以 及 赋值 运算 全， 如 = 运算 符 。 

本 章 主 要 介绍 数学 和 赋值 运算 付 ， 而 逻辑 运算 行将 在 第 4 半 中 介绍 ， 因 为 第 4 半 主 要 论述 控制 程序 流程 的 
布尔 逻辑 。 

运算 符 大 致 分 为 如 下 3 类 : 

e 一 元 运算 待 ， 处 理 一 个 操作 数 。 

e 二 元 运算 件 ， 处 理 两 个 操作 数 。 

e 三 元 运算 和 全， 处 理 三 个 操作 数 。 

大 多 数 运 鼻 符 都 是 二 元 运算 符 ， 只 有 几 个 一 元 运算 符 和 一 个 三 元 运算 符 ， 三 元 运算 符 即 条 件 运算 符 ( 条 件 运 
算 符 是 一 个 逻辑 运算 符 ， 详 见 第 4 章 )。 下 面 首 先 介绍 数学 运 复 符 ， 它 包括 一 元 运算 符 和 二 元 运算 符 。 


3.4.1 数学 运算 符 


有 5 个 简单 的 数学 运算 符 ， 其 中 两 个 小 和 一 有 二 元 和 一 元 两 种 形式 。 表 3-6 列 出 了 这 些 运算 符 ， 并 用 一 个 
简短 示例 来 说 明和 它们 的 用 法 ， 以 及 使 用 人 简单 的 数值 类 型 (整数 和 浮 扣 数 ) 时 它们 的 结果 。 


表 3-6 简单 的 数学 运算 符 


运算 符 类 si A R 
+ 二 元 varl = var2 + var3; varl 的 值 是 var2 与 var3 的 和 
- 二 元 varl = var? — var3; varl 的 值 是 从 var2 减 去 var3 所 得 的 值 
* 二 元 varl 的 值 是 var2 与 var3 的 乘积 
/ varl = var2 / var3: varl 是 var2 除 以 var3 所 得 的 值 
% 二 元 Varl = var2 % var3; varl 是 var2 除 以 var3 所 得 的 余数 
十 一 元 varl 的 值 等 于 var2 的 值 
- 一 元 varl 的 值 等 于 var2 的 值 乘 以 -1 
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注意 : 
+( 一 元 ) 运 算 符 有 点 二 怪 ， 因 为 它 对 结果 没有 影响 。 它 不 会 把 值 变 成 正 的 : 如 果 var? 是 -1， 则 +var2 仍 是 -1。 


但 这 是 一 个 得 到 普遍 认可 的 运算 符 ， 所 以 也 把 它 包 含 进来 。 这 个 运算 符 最 有 用 的 方面 是 ， 可 以 定制 它 的 操作 ， 
本 书 在 后 面 探讨 运算 符 的 重 载 时 会 介绍 它 。 

上 面 的 示例 都 使 用 简单 的 数值 类 型 ， 因 为 使 用 其 他 简单 类 型 ， 结 果 可 能 不 太 清 晰 。 例 如 把 两 个 布尔 值 加 在 
一 起 , 会 得 到 什么 结果 ? 因此 ， 如 果 对 bool 变量 使 用 +( 或 其 他 数学 运算 符 ),， 编译 器 会 报错 。char 变量 的 相 加 也 
会 有 点 让 人 摸 不 着 头脑 。 记 住 ，char 变量 实际 上 存储 的 是 数字 ， 所 以 把 两 个 char 变量 加 在 一 起 也 会 得 到 一 个 数 
as 这 是 一 个 隐 式 转换 示例 ， 稍 后 将 详细 介绍 这 个 主题 和 显 式 转换 ， 因 为 它 也 可 以 应 用 到 varl, 
var2 和 var3 是 混合 类 型 的 情况 。 

二 元 运算 符 + 在 用 于 字符 品类 型 变量 时 也 是 有 意义 的 。 此 时 ， 它 的 作用 如 表 3-7 所 示 。 


表 3-7 字符 串 连 接 运算 符 


+ mE varl = var2 + var3; varl 的 值 是 存储 在 var2 和 var3 中 的 两 个 字符 串 的 连 
B 


但 其 他 数学 运算 符 不 能 用 于 处 理 字符 串 。 
这 里 应 介绍 的 另 两 个 运 复 符 是 网 增 和 递减 运算 符 ， 它 们 都 是 一 元 运 复 待 ， 可 通过 两 种 方式 来 使 用 它们 : 放 
在 操作 数 的 前 面 或 后 面 。 简 单 表 达 式 的 结果 如 表 3-8 所 示 。 


表 3-8 ”递增 和 递减 运算 符 


a varl AE var? + 1, var? 递增 


varl 的 值 是 var2 -1，var2 递减 1 
varl 的 值 是 var2，var2 递增 1 
varl 的 值 是 var2，var2 递减 1 


这 些 运 算 符 会 改变 存储 在 操作 数 中 的 值 。 

e ++ 总 是 使 操作 数 加 1 

e 一 一 总 是 使 操作 数 减 1 

varl 中 存储 的 结果 有 区 别 ， 其 原因 是 运 拭 符 的 位 置 决定 了 它 什 么 时 候 友 挥 作用 。 把 运算 符 放 在 操作 数 的 前 
面 ， 则 操作 数 是 在 进行 任何 其 他 计算 前 党 到 运算 符 的 影响 ， 而 如 条 把 运算 符 放 在 操作 数 的 后 面 ， 则 操作 数 是 在 
完成 表达 式 的 计算 后 党 到 运算 符 的 影 啊 。 

再 看 一 个 示例 。 考 虑 以 下 代码 : 


int varl, var2 = 5, var3 = 6; 
varl = var2++ * --var3; 


要 把 什么 值 赋予 varl1? 在 计算 表达 式 前 ，var3 前 面 的 运算 符 - -会 起 作用 ， 把 它 的 值 从 6 改 为 5。 可 以 忽略 
var2 后 面 的 革 运 算 伯 ， 因 为 它 是 在 计算 完成 后 才 发 挥 作用 ， 所 以 varl 的 结果 是 5 与 $ 的 乘积 ， 即 25. 

许多 情况 下 ， 这 些 重 单 的 一 元 运算 符 使 用 起 来 非常 方便 ， 它 们 实际 上 是 下 述 表 达 式 的 简写 形式 : 

varl = varl + 1; 

这 类 表达 式 有 许多 用 途 ， 特 别 适 于 在 循环 中 使 用 ， 这 将 在 第 4 SEU. PAN DU DER ar np (SA Ces 5L 
符 ， 并 介绍 另外 两 个 有 用 的 概念 。 代 码 提 示 用 户 键入 一 个 字符 串 和 两 个 数字 ， 人 然后 显示 计算 结果 。 
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试 一 试 ”用 数学 运算 和 侍 处 理 变量 : Ch03Ex02\Program.cs 


(1) 在 目录 CABeginningCSharp7Chapter03 下 创建 一 个 新 的 控制 台 应 用 程序 Ch03Ex02 。 
(2) 在 Program.cs 中 添加 如 下 代码 : 


static void Main(string[] args) 
{ 
double firstNumber, secondNumber; 
string userName; 
Console.WriteLine ("Enter your name:"); 
userName = Console.ReadLine (); 
Console.WriteLine($"Welcome {userName}!") ; 
Console .WriteLine ("Now give me a number:"); 
firstNumber = Convert.ToDouble (Console.ReadLine());: 
Console.WriteLine("Now give me another number:"); 
secondNumber = Convert.ToDouble(Console.ReadLine(í)); 
Console.WriteLine($"The sum of {firstNumber} and {secondNumber} is " + 
$"[firstNumber + secondNumber}."); 
Console .WriteLine ($"The result of subtracting {secondNumber} from " + 
S"{firstNumber} is {firstNumber - secondNumber)."); 
Console.WriteLine ($"The product of {firstNumber} and {secondNumber} " + 
$"is {firstNumber * secondNumber}."); 
Console.WriteLine($"The result of dividing {firstNumber} by " + 
$"(secondNumber) is {firstNumber / secondNumber}."); 
Console.WriteLine($"The remainder after dividing (firstNumber) by " + 
$"(secondNumber) is {firstNumber $ secondNumber]."); 
Console.ReadEey(); 
} 


(3) 执行 代码 ， 结 果 如 图 3-2 所 示 。 


图 3-2 


图 3-3 


(5) 输入 一 个 数字 ， 按 下 回 车 键 ， 骨 输入 男 一 个 数字 ， 按 下 回 车 键 ， 结 果 如 图 3-4 所 示 。 


mima = 
wi fo 


示例 说 明 
除了 壮 示 数学 运算 符 外 ， 这 段 代码 还 引入 了 两 个 重要 概念 ， 在 以 后 的 示例 中 将 多 次 用 到 这 些 概念 : 
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e 用 户 输入 
用 户 输入 使 用 与 前 面 所 学 的 Console.WriteLine0 命 令 类 似 的 语法 。 但 这 里 使 用 Console.ReadLineO0。 这 个 命 
令 提 示 用 户 输 入 信息 ， 并 把 它们 存储 在 string 变量 中 : 


string userName; 

Console.WriteLine ("Enter your name:"); 
userName = Console.ReadLine(); 
Console.WriteLine (S"Welcome {userName}!"); 


这 段 代 码 直 接 将 已 赋值 变量 userName 的 内 容 写 到 屏 医 上。 
这 个 示例 还 读 取 了 两 个 数字 。 这 有 些 复杂 ， 因 为 Console.ReadLine0 命 令 生 成 一 个 字符 串 ， 而 我 们 希望 得 到 
一 个 数字 ， 所 以 这 了 束 引 入 了 类 型 转换 的 问题 。 第 5 章 将 详细 讨论 类 型 转换 ， 下 面 诈 先 分 析 本 例 使 用 的 代码 。 
首先 声明 要 存储 数字 输入 的 变量 : 
double firstNumber, secondNumber; 
接 看 给 出 提示 ， 对 Console.ReadLine0O 得 到 的 字符 串 使 用 命令 Convert.IoDouble0， 把 字符 串 转 换 为 double 
类 型 ， 把 这 个 数值 赋 给 前 面 声明 的 变量 firstNumber: 


Console.WriteLine ("Now give me a number:"); 
firstNumber = Convert.ToDouble (Console.ReadLine()); 


这 个 语法 相当 人 简单 ， 其 他 许多 转换 也 用 类 似 的 方式 进行 。 
其 余 代 人 码 按 同 样 方式 获取 第 二 个 数 : 


Console.WriteLine ("Now give me another number:"); 
secondNumber = Convert.ToDouble (Console.ReadLine()); 


然后 输出 两 个 数字 加 、 减 、 乘 、 除 的 结果 ， 并 用 余数 运算 符 (%g) 显 示 除 操作 的 余数 : 
Console.WriteLine($"The sum of {firstNumber} and {secondNumber} is ™ + 
S"{firstNumber + secondNumber]."); 
Console.WriteLine(S"The result of subtracting {secondNumber} from ™ + 
S"{firstNumber} is [firstNumber - secondNumber]."); 
Console.WriteLine($"The product of {firstNumber} and {secondNumber} " + 
5"is [firstNumber * secondNumber]."); 
Console.WriteLine($"The result of dividing {firstNumber} by " + 
S"{secondNumber} is {firstNumber / secondNumber]."); 
Console.WriteLine(S"The remainder after dividing {firstNumber} by " + 
S"{secondNumber} is {firstNumber $ secondNumber]."); 
注意 ， 我 们 提供 了 表达 式 firstNumber + secondNumber ^$, {FA Console.WriteLineiE 8JINJ— 2235, mix 
= f * , x E 
有 使 用 中 间 变 量 : 


Console.WriteLine (S"The sum of {firstNumber} and {secondNumber} is ™ + 
S"{firstNumber + secondNumber]."); 


这 种 语法 可 以 提高 代码 的 可 读 性 ， 并 减少 需要 编写 的 代码 量 。 


342 ”赋值 运算 符 

我 们 迄今 一 直 在 使 用 简单 的 = 赋值 运算 符 ， 其 实 还 有 其 他 赋值 运算 符 ， 而 且 它 们 都 很 有 用 。 除 了 三 运算 符 
外 ， 其 他 赋值 运算 符 都 以 类 似 方 式 工 作 。 与 三 一 样 ， 它 们 都 是 根据 运算 符 和 右边 的 操作 数 ， 把 一 个 值 赋 给 左边 
的 变量 。 

X 3-9 列 出 了 这 些 运算 符 及 其 说 明 。 


一 表 3-9 ”赋值 运算 符 
运算 符 结果 
- varl 被 赋予 var? 的 值 
m varl WERT varl 55 var 的 和 
-一 varl 一 Var2: varl 被 赋予 varl 与 var2 We 
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( 续 表 ) 
运算 符 a m 
+= varl 被 赋予 varl 与 var2 的 乘积 
[- varl 被 赋予 varl 与 var2 相 除 所 得 的 结果 
varl 被 赋予 varl 与 var2 相 除 所 得 的 余数 


可 以 看 出 ， 这 些 运算 符 把 varl 也 包括 在 计算 过 程 中 ， 例 如 : 

varl += var2; 

5 Pim As RARI. 

varl = varl + var2; 

注意 : 

与 + 运算 符 一 样 ，+= 运 算 符 也 可 用 于 字符 囊 。 

使 用 这 些 运 复 竺 ， 特 别 是 在 使 用 长 变量 名 时 ， 可 使 代码 更 便于 阅读 。 


3.4.3 运算 符 的 优先 级 

在 计算 表达 式 时 ， 会 按 顺序 处 理 每 个 运算 符 。 但 这 并 不 意味 着 必须 从 左 至 右 地 运用 这 些 运算 待 。 例 如 ， 考 
虑 下 面 的 代码 : 

Varl = var2 + var3; 

其 中 + 运算 得 就 是 在 二 运算 从 之 前 进行 计算 的 。 在 其 他 一 些 情况 下 ， 运 算 和 从 的 优先 级 并 没有 这 么 明显 ， 
例如 : 

varl = var2 + var3 * var4; 

RAPRA AWE, JRE, Un WT. REENA A RNU, ARS RATER 
上 进行 算术 运算 的 结果 相同 。 

像 这 样 的 计算 ， 可 以 使 用 括号 控制 运算 符 的 优先 级 ， 例 如 : 

varl = (var2 + var3) * var4; 

首先 计算 括号 中 的 内 容 ， 即 + 运算 符 在 * 运 算 和 从 之 前 计算 。 

对 于 前 面 介 绍 的 运算 人生， 其 优先 级 如 表 3-10 所 示 ， 优 先 级 相同 的 运算 符 ( 如 * 和 由 按照 从 左 至 右 的 顺序 计算 。 

表 3-10 ”运算 符 的 优先 级 


优 先 级 z wu 
优 ++、 一 一 (用 作 前 组 )、+、- (一 元 ) 
7c *. [, 96 
级 
由 +. = 
到 =. =. FF. %=, +=, -二 
‘ Hy ORES 
注意 : 


如 上 所 述 ， 括 号 可 用 于 重 写 优先 级 顺序 。 另 外 ，+TH 和 - -用 作 后 缓 运算 符 时 ， 在 概念 上 其 优先 级 最 低 ， 如 表 
3-10 所 示 。 它 们 不 对 赋值 表达 式 的 结果 产生 影响 ， 所 以 可 以 认为 它们 的 优先 级 比 所 有 其 他 运算 符 都 高 。 但 是 ， 
它们 会 在 计算 表达 式 后 改变 操作 数 的 值 ， 所 以 认为 它们 的 优先 级 如 表 3-10 所 示 会 十 分 方便 。 
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344 ”名 称 空间 


在 继续 学 习 前 ， 应 花 一 定 的 时 间 了 解 一 个 比较 重要 的 主题 一 一 名 称 空间 。 它们 是 .NET 中 提供 应 用 程序 代码 
容器 的 方式 ， 这 样 束 可 以 唯一 地 标识 代码 及 其 内 容 。 名 称 空间 也 用 作 .NET Framework 中 给 项 分 类 的 一 种 方式 。 
大 多 数 项 部 是 类 型 定义 ， 例 如 ， 本 章 摘 述 的 简 早 类 型 (System.Int32 等 )。 

默认 情况 下 ，C# 代 人 码 包含 在 全 局 名 称 空间 中 。 这 意味 看 对 于 包含 在 这 段 代 人 码 中 的 项 ， 全 局 名 称 空 间 中 的 其 
他 代码 只 要 通过 名 称 进行 有 引用， 就 可 以 访问 它们 。 可 使 用 namespace 关键 字 为 化 括号 中 的 代码 块 显 式 定义 名 称 
空间 。 如 朱 在 该 名 称 空间 代码 的 外 部 使 用 名 称 空 间 中 的 名 称 ， 就 必须 写 出 该 名 称 空间 中 的 限定 名 称 。 

限定 名 称 包 括 它 所 有 的 分 层 信 息 。 这 意味 着 ， 如 果 一 个 名 称 空间 中 的 代码 需要 使 用 在 另 一 个 名 称 空间 中 定 
义 的 名 称 ， 就 必须 包括 对 该 名 称 空间 的 引用 。 限 定名 称 在 不 同 的 名 称 空间 级 别 之 间 使 用 句点 字符 ()， 如 下 所 示 : 

namespace Levelone 


// code in LevelOne namespace 
// name "NameOne" defined 


// code in global namespace 

这 段 代码 定义 了 一 个 名 称 空间 LevelOne， 以 及 该 名 称 空间 中 的 一 个 名 称 NameOne( 注 意 这 里 在 应 该 定义 名 
称 空间 的 地 方 添加 了 一 个 注释 , 而 没有 列 出 实际 代码 , 这 是 为 了 使 我 们 的 讨论 更 具 普 记性)。 在 名 称 空间 LevelOne 
中 编写 的 代码 可 以 直接 使 用 NameOne 来 引用 该 名 称 ， 但 全 局 名 称 空间 中 的 代码 必须 使 用 限定 名 称 
LevelOne.NameOne 来 引用 这 个 名 称 。 

需要 注意 特别 重要 的 一 操 : using 语句 本 身 不 能 访问 另 一 个 名 称 空间 中 的 名 称 。 除 非 名 称 空间 中 的 代码 以 霖 
种 方式 链接 到 项 目 上 ， 或 者 代码 是 在 该 项 目的 源 文件 中 定义 的 ， 或 者 是 在 链接 到 该 项 目的 其 他 代码 中 定义 的 ， 
否则 残 不 能 访问 其 中 包含 的 名 称 。 另 外 ， 如 果 包 舍 名 称 空间 的 代码 链接 到 项 目 上 ， 那 么 无 论 是 否 使 用 using， 都 
可 以 访问 其 中 包含 的 名 称 。using 语句 便于 我 们 访问 这 些 名 称 ， 减 少 代码 量 ， 以 及 提高 可 读 性 。 

头 分 析 本 章 开 头 的 ConsoleApplicationl 中 的 代码 ， 会 看 到 下 面 这 些 被 应 用 到 名 称 空间 上 的 代码 : 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 


namespace ConsoleApplicationl 


{ 

s 

以 using 关键 字 开 头 的 5 行 代码 声明 在 这 段 C# 代 码 中 使 用 System. System.Collections.Generic. System.Linq. 
System.Text 和 System.Threading.Tasks 名 称 空间 , 它们 可 以 在 该 文件 的 所 有 名 称 空间 中 访问 ,不必 进行 限定 。 System 
名 称 空间 是 NET Framework 应 用 程序 的 根 各 称 空间 ,包含 控制 台 应 用 程序 需要 的 所 有 基本 功能 。 其 他 4 个 名 各 
空间 常用 于 控制 台 应 用 程序 ， 所 以 该 程序 包含 了 和 它们。 最后， 为 应 用 程序 代码 本 号 声明 一 个 名 称 空间 
ConsoleApplication]。 

C# 6913 J using static 关键 字 。 这 个 关键 字 允许 把 静态 成 员 直 接 包含 到 C# 程 序 的 作用 域 中 。 例 如 ， 本 章 
的 两 个 示例 都 使 用 了 System.Console 静态 类 中 的 System.Console.WTiteLine0 方 法 。 注 意 ， 在 这 些 例 子 中 ， 应 包 
插 Console 类 和 WriteLine0 方 法 。 把 using static System.Console 玖 加 到 名 称 空 间 列 表 中 时 ,访问 WriteLineQ77 14; 
束 不 再 需要 在 前 面 加 上 裔 态 类 名 。 

之 后 需要 System .Console 静态 类 的 所 有 代码 示例 束 包 后 using static System.Console 关键 字 。 
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(1) 在 下 面 的 代码 中 ， 如 何 从 名 称 空间 fabulous 的 代码 中 引用 名 称 great? 


namespace fabulous 
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// code in fabulous namespace 


namespace super 
; namespace smashing 
' // great name defined 
} | 
(2) 下 面 哪些 变量 名 不 合法 ? 
my VariableIsGood 
99F lake 
_ floor 
time2GetJiggy WidIt 
wrox.com 
(3) 47 4"supercalifragilisticexpialidocious"7 4 z& ATK J, 不 能 放 在 string 变量 中 ?如 果 是 , 原因 是 什么 ? 
(4) 考虑 运算 符 的 优先 级 ， 列 出 下 述 表达 式 的 计算 步骤 : 


resultVar += varl * varž + var3 $ var4 / varb; 


(5) 编写 一 个 控制 台 应 用 程序 ， 要 求 用 户 输入 4 个 int 值 ， 并 显示 它们 的 乘积 。 提 示 : 前 面 看 到 可 以 使 用 
Convert.ToDouble0 命 令 把 用 户 在 控制 台 上 输入 的 数 转换 为 double 类 型 ， 类 似 地 ， 从 string 类 型 转换 为 int 类 型 
的 命令 是 Convert.ToInt320。 

附录 A 给 出 了 习题 答案 。 
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+ 题 要 A 
C# 是 一 种 区 分 大 小 写 的 语言 ， 每 行 代码 都 以 分 号 结束 。 如 果 代 码 行 太 长 或 者 想 要 标识 柑 套 的 块 ， 可 以 缩 进 代码 
行 ， 以 方便 阅读 。 使 用 /或 *+...*/ 语 法 可 以 包含 不 编译 的 注释 。 代 码 块 可 以 隐藏 到 区 域 中 ， 也 是 为 了 方便 阅读 
变量 是 有 名 称 和 类 型 的 数据 块 。NET Framework 定义 了 大 量 简单 类 型 ， 例 如 数字 和 字符 串 (文本 ) 类 型 ， 以 供 合 
变量 用 。 变 量 只 有 经 过 声明 和 初始 化 后 ， 才 能 使 用 。 可 以 把 字面 值 赋予 变量 ， 以 初始 化 它们 ， 变 量 还 可 在 单个 步 又 

中 声明 和 初始 化 

表达 式 利用 运算 符 和 操作 数 来 建立 ， 其 中 运算 符 对 操作 数 执行 操作 。 运 算 符 有 3 种 ， 一 元 、 二 元 和 三 元 运算 符 ， 
表达 式 它们 分 别 操作 1、2 和 3 个 操作 数 。 数 学 运算 符 对 数值 执行 操作 ， 赋 值 运算 符 把 表达 式 的 结果 放 在 变量 中 。 运 算 

符 有 固定 的 优先 级 ， 优 先 级 确定 了 运算 符 在 表达 式 中 的 处 理 顺 序 

NET 应 用 程序 中 定义 的 所 有 名 称 ， 包 括 变量 名 ， 都 包含 在 名 称 空间 中 。 名 称 空间 采用 层次 结构 ， 我 们 通常 需要 

根据 包含 名 称 的 名 称 空间 来 限定 名 称 ， 以 便 访问 它们 


C# 基 本 语法 


名 称 空间 


第 
流程 控制 


REBAR: 

e 布尔 逻辑 的 用 法 

e 如何 控制 代码 的 分 支 
e 如 何 编写 循环 代码 


本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter04 文件 夹 中 并 已 根据 本 章 示例 的 名 称 
单独 命名 。 


我 们 迄今 看 到 的 所 有 C# 代 码 有 一 个 共同 点 : 程序 的 执行 都 是 一 行 接 一 行 、 目 上 而 下 地 进行 ， 不 遗漏 任何 代 
码 。 如 果 所 有 应 用 程序 都 这 样 执行 ， 我 们 能 做 的 工作 就 很 有 限 了 。 本 间 介 绍 控制 程序 流程 的 两 种 方法 。 程 序 流 
程 就 是 C# 代 码 的 执行 顺序 。 这 两 种 方法 是 分 支 和 循环 。 分 支 根据 计算 的 结果 有 条 件 地 执行 代码 ， 例 如 ,，“ 只 有 
变量 myVal 的 值 小 于 10， 才 执行 这 行 代码 ”。 御 环 重复 执行 相同 的 语句 (重复 执行 一 定 的 次 数 ， 或 在 满足 测试 条 
件 后 才 停 止 执 行 )。 

这 两 种 方法 都 用 到 了 布尔 逻辑 。 第 3 章 介 绍 了 bool RAY, 但 并 未 过 多 地 讨论 它 。 本 章 将 在 很 多 地 方 使 用 它 ， 
所 以 先 讨论 布尔 逻辑 ， 以 便 在 流程 控制 环境 下 使 用 它 。 


4.4 布尔 逻辑 


第 3 EIN] bool 类 型 可 以 有 两 个 值 : true 或 false。 这 种 类 型 常用 于 记录 某 些 操 作 的 结果 ， 以 便 处 理 这 些 
结果 。 特 别 是 ，bool 类 型 可 用 于 存储 比较 的 结果 。 


注意 : 

19 世纪 中 叶 的 英国 数学 家 乔治 ，。 布 尔 (George Boole) 为 布尔 逻辑 英 定 了 基础 。 

例如 ， 考 虑 下 述 情形 (如 本 章 引言 所 述 ): 要 根据 变量 myVal 的 值 是 否 小 于 10 来 确定 是 否 执行 代码 。 为 此 ， 
需要 确定 语句 “myVal 小 于 10” 的 真 假 ， 即 需要 了 解 比较 的 布尔 结果 。 
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部 分 C# 语言 
布尔 比较 需要 使 用 布尔 比较 运算 从 (也 称 为 关系 运算 符 )， 如 表 4-1 Bran. 


表 4-1 布尔 比较 运算 符 


运算 符 示例 表达 式 结 R 


== 二 元 varl = var2 == var3: 如 果 var? 等 于 var3, varl 的 值 就 是 true, 否则 
为 false 

E- J varl = var? !- var3; 如 果 var2 不 等 于 var3, varl 的 值 就 是 true, F 
则 为 false 

< varl = var? < var3; 如 果 var? 小 于 var3, varl 的 值 就 是 true， 否 则 
73 false 

> varl = var2 > var3; 如 果 var? AF var3, varl 的 值 就 是 true, FI 
为 false 

<= 3 varl = var? <= var3: 如 果 var2 小 于 或 等 于 var3, varl 的 值 就 是 true， 
BUA false 

>= | var] = var2 >= var3: 如 果 var2 大 于 或 等 于 var3, varl 的 值 就 是 true， 
否则 为 false 


那么 


在 表 4-1 中 ，varl 都 是 bool 类 型 的 变量 ，var2 和 var3 则 可 以 是 不 同类 型 。 
在 代码 中 ， 可 以 对 数值 使 用 这 些 运 算 符 : 


bool isLessThanl0; 
isLessThanl0 = myVal < 10; 


如 果 my Val 存储 的 值 小 于 10， 这 段 代 码 就 给 isLessThan10 赋予 tue 值 ， 否 则 赋予 false (Ë. 
也 可 以 对 其 他 类 型 使 用 这 些 比较 运算 符 ， 例 如 字符 串 : 


bool isBenjamin; 
isBenjamin = myString == "Benjamin"; 


如 果 myString 存储 的 字符 串 是 “Benjamin”，isBenjamin 的 值 就 为 true。 
也 可 以 对 布尔 值 使 用 这 些 运 复 符 : 


bool isTrue; 
isTrue = myBool == true; 


但 只 能 使 用 一 和 != 运 算 符 。 


注意 : 
错误 地 认为 当 vall < val2 为 false 时 ，vall >val2 为 tue， 则 会 导致 一 个 和 常见 的 代码 错误 。 如果 vall = val2， 
前 两 条 语句 都 是 false. 


&A | 运 复 符 也 有 两 个 类 似 的 运算 符 ， 称 为 条 件 布尔 运算 符 ( 见 表 4-2)。 


表 4-2 条件 布 尔 运算 符 


运算 符 S j} 示例 表达 式 结 R 
&& : varl = var2 && var3: 如 果 var? 和 var3 都 是 true,varl 的 值 就 是 true, FMA false 
(逻辑 与 ) 
| var] = var2 || var3; 如 果 var2 或 var3 是 true( 或 两 者 都 是 )，varl 的 值 就 是 tue, FF 
则 为 false (逻辑 或 ) 


这 些 运 算 符 的 结果 与 & 和 | 完全 相同 ， 但 得 到 结果 的 方式 有 一 个 重要 区 别 ， 其 性 能 更 好 。 两 者 都 是 检查 第 


一 个 操作 数 的 值 ( 表 4-2 中 的 var2)， 如 果 已 经 能 判断 结果 ， 束 根本 不 必 处 理 第 二 个 操作 数 ( 表 4-2 中 的 var3)。 
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a Ree 运算 符 的 第 一 个 操作 数 是 false， 就 不 需要 考虑 第 二 个 操作 数 的 值 了 ， 因 为 无 论 第 二 个 操作 数 的 值 
是 什么 ， 其 结果 都 是 false。 同 样 ， 如 果 第 一 个 操作 数 是 true, || 运算 符 就 返回 true， 不 必 再 考虑 第 二 个 操作 数 
的 值 。 


41.1 布尔 按 位 运算 符 和 赋值 运算 符 


使 用 布尔 赋值 运算 符 可 以 把 布尔 比较 与 赋值 组 合 起 来 ， 其 方式 与 第 3 章 中 的 数学 赋值 运算 从 (t=、*= 等 ) 相 
I]. p^ RA EDS SER UI 4-3 所 示 。 当 表达 却 使 用 赋值 二 和 按 位 运 复 符 ( 放 、|、 久 时 ， 残 使 用 所 比较 数值 的 二 进 
制 表示 来 计算 结果 ， 而 不 是 使 用 整数 、 字 符 串 或 相似 的 值 。 
表 4-3 布尔 赋值 运算 符 
运算 符 | 类 a | 示例 表达 式 00 结果 
&= FE EN varl &- var2; varl 的 值 是 varl & var2 的 结果 
= = varl |= var2; varl 的 值 是 varl | var2 的 结果 
^ 一 元 varl “= var2; varl 的 值 是 varl ^ var2 的 结果 


例如 ， 等 式 varl ^= var2 类 似 于 varl = varl ^var2， 其 中 varl =true. var2 = false。 当 比较 false 的 二 进 制 表 
ZR 0000 与 true( 一 般 不 是 0000 的 任何 什 ， 通 第 是 0001) 时 ，varl RIZE WY true. 

注意 : 

及 = 和 p 赋值 运算 符 并 不 使 用 及 及 和 | 条 件 布尔 运算 符 ， 即 无 论 赋值 运算 符 左 边 的 值 是 什么 ， 都 处 理 所 有 


与 许多 其 他 示例 一 样 ， 下 面 的 示例 假定 在 文件 项 部 的 using 部 分 添加 了 “using static System.Console. 
和 “using static System. Convert. i ( 如 有 必 要 ) 语句 |。 


试 一 试 ”使 用 布尔 运算 符 : Ch04Ex01\Program.cs 


(1) 在 目录 CABeginningCSharp7\Chapter04 下 创建 一 个 新 的 控制 台 应 用 程序 Ch04Ex01。 
(2) 将 以 下 代码 添加 到 Program.cs 中 : 
static void Main(string[] args) 
{ 
WriteLine ("Enter an integer:"); 
int myInt = ToInt32 (ReadLine()); 
bool isLessThanlO = myInt < 10; 
bool isBetweenOAndb5 = (0 <= myInt) && (myInt <= 5); 
WriteLine($"Integer less than 10? {isLessThan10}") ; 
WriteLine($"Integer between 0 and 5? {isBetween0And5}") ; 
WriteLine($"Exactly one of the above is true? " + 
$"(isLessThanlO ^ isBetweenOAndb)"); 
ReadRey () ; 
} 


(3) 运行 该 应 用 程序 ， 出 现 提示 时 ， 输 入 一 个 整数 ， 结 果 如 图 4-1 所 示 。 


4-1 
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示例 说 明 
前 两 行 代码 使 用 前 面 介 绍 的 技术 ， 提 示 并 接受 一 个 整数 值 : 


WriteLine ("Enter an integer:"); 
int myInt = ToInt32 (ReadLine()); 


使 用 ToInt320 从 字符 串 输 入 中 得 到 一 个 整数 。ToInt320 是 另 一 个 类 型 转换 命令 ， 与 前 面 使 用 的 ToDouble() 
命令 属于 同一 系列 。Tomt320 和 ToDouble0 方 法 是 System.Convert 静态 类 的 一 部 分 。 如 第 3 AR, AM C# 6 
之 后 ， 就 可 以 在 包括 的 名 称 空间 列表 中 包含 using static System.Convert 类 ， 直 接 访问 静态 类 (在 这 个 示例 中 是 
System.Convert) 的 方法 。 还 要 注意 ,没有 检查 用 户 是 耕 输入 了 一 个 整数 。 如 果 提 供 的 值 不 是 整数 ， 例 如 字符 串 ， 
在 试图 执行 转换 时 会 发 生 异常 。 可 以 使 用 try{ }...catch{ } 块 处 理 这 种 情况 ， 或 在 执行 转换 之 前 使 用 GetTypeO 
方法 ， 检 查 输 入 的 值 是 不 是 一 个 整数 。 这 两 种 方法 将 在 后 续 章 市 讨论 。 

接着 声明 两 个 布尔 变量 : isLessThan10 和 isBetween0And5， 并 赋值 ， 其 中 的 逻辑 匹配 其 名 称 中 的 描述 : 


bool isLessThanlO0 = myInt < 10; 
bool isBetween0And5 = (0 <= myInt) && (myInt <= 5); 


接着 在 下 面 的 3 行 代码 中 使 用 这 些 变量 ， 前 两 行 代码 输出 它们 的 值 ， 而 第 3 行 对 它们 执行 一 个 操作 ， 并 输 
出 结果 。 在 执行 这 段 代码 时 ， 假 定 用 户 输 入 了 7， 如 图 4-1 所 示 。 

第 一 个 输出 是 操作 mylnt < 10 的 结果 。 如 果 mylnt 是 7， 则 它 小 于 10， 因 此 结果 为 tue。 如 果 MylInt 的 值 
是 10 或 更 大 ， 就 会 得 到 false. 

第 二 个 输出 涉及 较 多 计算 : (0 <= myInt) && (myInt <= 5)， 其 中 包含 两 个 比较 操作 ， 用 于 确定 myImt EEK 
于 或 等 于 0, 且 小 于 或 等 于 5。 接着 对 结果 进行 布尔 AND 操作 。 输入 数字 7, 则 (0 <= myInb 返 回 true, 而 (myInt 
<= 5) 返回 false， 最 终结 果 就 是 (true) && (false), BI false， 如 图 4-1 所 示 。 

最 后 ， 对 两 个 布尔 变量 isLessThan10 和 isBetween0And5 执行 逻辑 异 或 操作 。 如 果 一 个 变量 的 值 是 tue， 另 
一 个 是 false， 则 代码 返回 tue. FURE myInt 是 6、7、8 或 9 时 , JRE tme， 本 例 输入 的 是 7， 所 以 结果 是 
true. 


41.2 运算 符 优 先 级 的 更 新 
现在 要 考虑 更 多 的 运算 符 ， 所 以 应 更 新 第 3 章 中 的 运算 符 优先 级 表 3-10， 把 它们 包括 在 内 ， 如 表 4-4 所 示 。 


表 4-4 ”运算 符 优先 级 (更 新 后 ) 


优 先 级 运 8 符 

+, 一 (用 作 前 缀 ): (). +. - (一 元 ), !,~ 
* [96 
t, EN 
<< => 

优 Nr es 

先 = = 

级 = 

由 & 

高 A 

到 | 

" && 


= t= /=, Y=, +, = K, >>, = A— = 
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该 表 增 加 了 好 几 个 级 别 ， 但 它 明 确定 义 了 下 述 表 达 式 该 如 何 计算 : 

varl = var2 <= 4 && Var2 >= 2; 

其 中 有 && 运 算 和 从 在 <= 和 >= 运 算 符 之 后 执行 (在 这 行 代码 中 ，var2 是 一 个 int 值 )。 

这 里 要 注音 的 是 ， 添 加 括号 可 以 使 这 样 的 表达 式 看 起 来 更 清晰 。 编 详 絮 知道 用 什么 顺序 执行 运算 得， 但 人 
们 第 会 悉 记 这 个 顺序 (有 时 可 能 想 改变 这 个 顺序 )。 上 述 表 达 式 也 可 以 写 为 : 

varl = (var2 <= 4) && (var2 >= 2); 


通过 明确 指定 计算 的 顺序 就 解决 了 这 个 问题 。 
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分 文 是 控制 下 一 步 要 执行 哪 行 代码 的 过 程 。 要 跳 转 到 的 代码 行 由 某 个 条 件 语句 来 控制 。 这 个 条 件 语句 使 用 
布尔 逻辑 ， 对 测试 值 和 一 个 或 多 个 可 能 的 值 进 行 比较 。 

本 节 介 绍 C# 中 的 3 种 分 支 技术 : 

e if isn) 


e switch 语句] 


421 三 元 运算 符 


最 简单 的 比较 方式 是 使 用 第 3 革 介 绍 的 三 元 (或 条 件 ) 运 算 符 。 一 元 运算 付 有 一 个 操作 数 ， 二 元 运算 特有 两 
个 操作 数 ， 所 以 三 元 运算 特有 三 个 操作 数 。 其 语法 如 下 : 


«Ltest- ? <resultifTrue>: <resultifFalse> 


其 中 ， 计 算 <tesf> 可 得 到 一 个 布尔 值 ， 运 复 符 的 结果 根据 这 个 值 来 确定 是 <resultIfIrue> 还 是 <resultIfFalse>。 
使 用 三 元 运 鼻 符 可 以 测试 mt 变量 myInteger 的 值 ， 如 下 所 示 : 


string resultString = (myInteger < 10) ? "Less than 10" 
: "Greater than or equal to 10"; 


三 元 运算 符 的 结果 是 两 小字 符 串 中 的 一 个 ， 这 两 个 字符 串 都 可 能 赋 给 resultSting。 把 哪个 字符 串 赋 给 
resultString， 取 诀 于 mylInteger 的 值 与 10 的 比较 结果 。 如 果 mylnteger 的 值 小 于 10， 就 把 第 一 个 字符 串 赋 给 
resultString; 如 果 myInteger 的 值 大 于 或 等 于 10， 束 把 第 二 个 字符 串 赋 给 resultString。 例 如 ， 如 果 mylnteger 的 
值 是 4， 则 resultString 的 值 就 是 字符 串 "Less than 10". 


4.2.2 于 语句 


站 语句 的 功能 比较 多 ， 是 一 种 有 效 的 决策 方式 。 与 ? :语句 不 同 的 是 , 站 语句 没有 结果 (所 以 不 在 赋值 语句 中 
使 用 它 )， 使 用 该 语句 是 为 了 根据 条 件 执行 其 他 语句 。 
下 语句 最 简单 的 语法 如 下 : 


if («test») 
«code executed if «test» is true»; 


先 执行 <test>( 其 计算 结果 必须 是 一 个 布尔 值 ， 这 样 代码 才能 编 详 )， 如 果 <test> 的 计算 结果 是 tue， 就 执行 该 语 
名 之 后 的 代码 。 这 段 代码 执行 完毕 后 ， 或 者 因为 <tes 亿 的 计算 结果 是 false， 而 没有 执行 这 段 代 码 ， 将 继续 执行 
后 面 的 代码 行 。 

也 可 将 else 语句 和 于 语句 合并 使 用 ， 指 定 其 他 代码 。 如 果 <test> 的 计算 结果 是 false, PTT else iJ: 


if (<test>) 

<code executed if <test> is true>; 
else 

<code executed if <test> is false>; 
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可 使 用 成 对 的 花 括号 将 这 两 段 代码 放 在 多 个 代码 行 上 : 


if (<test>) 


{ 

«code executed if <test> is true»; 
} 
else 
{ 

«code executed if <test> is false»; 
} 


例如 ， 重 新 编写 上 一 节 使 用 三 元 运算 符 的 代码 : 


string resultString = (myInteger < 10) ? "Less than 10" 
: "Greater than or equal to 10"; 


因为 站 语句 的 结果 不 能 赋 给 一 个 变量 ， 所 以 要 单独 给 变量 赋值: 


string resultString; 
if (myInteger < 10) 
resultString = "Less than 10"; 
else 
resultString = "Greater than or equal to 10"; 


这 样 的 代码 尽管 比较 元 长 ， 但 与 对 应 的 三 元 运 复 符 形式 相 比 ， 更 便于 阅读 和 理解 ， 也 更 灵活 。 
下 面 的 示例 演示 了 站 语句 的 用 法 。 


试 一 试 ” 使 用 if 语 句 : Ch04Ex02\Program.cs 


(1) 在 目录 C:\BeginningCSharp7\Chapter04 中 创建 一 个 新 的 控制 台 应 用 程序 Ch04Ex02。 
(2) 把 下 列 代 码 添 加 到 Program.cs "P: 


static void Main(string[] args) 
{ 
string comparison; 
WriteLine ("Enter a number:"); 
double varl = ToDouble (ReadLine()); 
WriteLine ("Enter another number:"); 
double var? = ToDouble (ReadLine()); 
if (varl < var2) 
comparison = "less than"; 
else 
( 
if (varl -- var2) 
comparison = "equal to"; 
else 
comparison = "greater than"; 
) 
WriteLine($"The first number is {comparison} " + 
$"the second number."); 
ReadkKey () ; 
} 


(3) 执行 代码 ， 根据 提示 输入 两 个 数字 ， 如 图 4-2 所 示 。 


图 4-2 


示例 说 明 
我 们 已 经 十 分 熟悉 代码 的 第 一 部 分 ， 它 从 用 户 输 入 中 得 到 两 个 double 值 : 


string comparison; 

WriteLine ("Enter a number:"); 
double varl = ToDouble (ReadLine()); 
WriteLine ("Enter another number:"); 
double var2 = ToDouble (ReadLine()); 
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接 看 根据 varl 和 var2 的 值 ， 将 一 个 字符 串 赋 给 string 变量 comparison。 首 先 看 看 varl 是 否 小 于 var2: 


= i = less than"; 

如 果 不 是 ， 则 varl 大 于 或 等 于 var2。 在 第 一 个 比较 操作 的 else BROT, ae BK ITI: 
else 
{ 


if (varl == var2) 
comparison = “equal to"; 


只 有 在 varl KF var2 时 ， 才 执行 第 二 个 比较 操作 中 的 else 部 分 : 


else 
comparison = "greater than"; 


} 
最 后 将 comparison 的 值 写 到 控制 台 : 


WriteLine("The first number is {0} the second number.", 
comparison); 
3x Ht fs FH HR AE H EET IRAE LER, MS T UA OB RES: 
if (varl < var2) 
comparison = "less than"; 
if (varl == var2) 
comparison = "equal to"; 
if (varl > var2) 
comparison = "greater than"; 


这 种 方式 的 缺点 在 于 : 无 论 varl 和 var2 的 值 是 什么 ， 都 要 执行 3 个 比较 操作 。 在 第 一 种 方式 中 ， 如 果 
varl < var2 是 tue， 束 只 执行 一 个 比较 操作 ， 合 则 融 要 执行 两 个 比较 操作 (还 执行 了 varl == var2 比较 操作 )， 这 
样 将 使 执行 的 代码 行 较 少 。 在 本 例 中 性 能 上 的 差异 较 小 ， 但 在 较 重 视 性 能 的 应 用 程序 中 ， 差 异 束 很 明显 了 。 


使 用 if 语句 判断 更 多 条 件 
在 上 例 中 ,检查 了 涉及 val 的 值 的 3 个 条 件 ， 包 括 这 个 变量 所 有 可 能 的 值 。 有 时 要 检查 特定 的 值 ， 例 
如 varl ERST 1]、2、3 或 4 等 。 使 用 上 和 面 那样 的 代码 会 得 到 很 多 烦人 的 钦 套 代码 : 
if (varl == 1) 
// Do something. 
else 
{ z 
if (varl == 2) 
// Do something else. 
Te 
i 
if (varl == 3 || varl == 4) 
// Do something else. 
ion 


// Do something else. 


} 
} 


警告 : 

人 们 经 常会 错误 地 将 诸如 这 varl 王 3||varl = DAYS A if (varl ==3| 4。 由 于 运算 符 具有 优先 级 ， 因 
此 首先 执行 一 运算 符 ， 接 着 用 | 运算 符 处 理 布尔 和 数值 操作 数 ， 就 会 出 现 错误 

这 些 情况 下 ， 就 要 使 用 稍 有 不 同 的 缩 进 模式 ， 缩 短 else 代码 块 ( 即 在 else 块 的 后 面 使 用 一 行 代码 而 不 是 一 个 
代码 块 )， 这 样 束 得 到 了 else 站 语句 结构 : 


if (varl == 1) 
{ 
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// Do something. 

else if (varl == 2) 
// Do something else. 

else if (varl == 3 || varli == 4) 
// Do something else. 

] 

else 


// Do something else. 
} 
这 些 else 站 语句 实际 上 是 两 个 独立 的 语句 ， 它 们 的 功能 与 上 述 代 码 相 同 ， 但 更 便于 阅读 。 像 这 样 进行 多 个 
比较 的 操作 ， 应 考虑 使 用 男 一 种 分 文 结构 ;switch 语句 。 


423 switch 语句 


switch 语句 非常 类 似 于 让 语句， 因为 它 也 是 根据 测试 的 值 来 有 条 件 地 执行 代码 。 但 是 ，switeh 语句 可 以 一 
次 将 测试 变量 与 多 个 值 进行 比较 ， 而 不 是 仅 测 试 一 个 条 件 。 这 种 测试 仅 限 于 离散 的 值 ， 而 不 是 像 “ 大 于 X” 这 
样 的 子 句 ， 所 以 它 的 用 法 有 点 不 同 ， 但 它 仍 是 一 种 强大 的 拉 术 。 

switch 语句 的 基本 结构 如 下 : 


switch (<testvar>) 
{ 
case <comparisonVall>: 
«code to execute if <testVar> == <comparisonVall> > 
break; 
case <comparisonVal2>: 
<code to execute if <testVar> == <comparisonVal2> > 
break; 


case «comparisonValN»: 


«code to execute if <testVar> == <comparisonValN> > 
break; 

default: 
«code to execute if <testVar> != comparisonVals> 
break; 


] 

<testVar>"P [B8 5 8ET-«-comparisonValX-1B8 (f£ case 语句 中 指定 ) 进 行 比较 ， 如 果 有 一 个 匹配 ， 惑 执行 为 该 
匹配 提供 的 语句 。 如 果 没 有 匹配 ， 但 有 default 语句 ， 就 执行 default 部 分 的 代码 。 

执行 完 每 个 部 分 的 代码 后 ， 还 需要 有 另 一 个 语句 break。 在 执行 完 一 个 case 块 后 ， 再 执行 第 二 个 case 语句 
是 非法 的 。 


EE n 
在 此 ， C45 C++ 是 有 区 别 的 。 在 C++ 中 $ 可 以 在 运行 完 一 个 Case WE 运行 3 一 个 Case 语句 总 


这 里 的 break 语句 将 中 断 switch 语句 的 执行 ， 而 执行 该 结构 后 面 的 语句 。 

E C# 代 人 码 中 ， 还 有 其 他 方法 可 以 防止 程序 流程 从 一 个 case 语句 转 到 下 一 个 case 语句 。 可 以 使 用 retum 语 
句 ， 中 断 当前 函数 的 运行 ， 而 不 是 仅 中 断 switch 结构 的 执行 ( 详 见 第 6 3x). tu] LEH goto 语句 (如 前 所 述 )， 
因为 case 语句 实际 上 是 在 C# 代 人 码 中 定义 的 标签 。 例 如 : 


switch (<testvar>) 
{ 
case <comparisonVall>: 
«code to execute if <testVar> == «comparisonVall» > 
goto case <comparisonVal2>; 
case <comparisonVal2>: 
«code to execute if <testVar> == <comparisonVal2> > 
break; 


一 个 case 语句 处 理 完毕 后 ， 不 能 自由 进入 下 一 个 case 语句 ， 但 这 条 规则 有 一 个 例外 。 如 果 把 多 个 case if 
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句 放 在 一 起 ( 扒 侣 它们 )， 其 后 加 一 个 代码 块 ， 实 际 上 坪 一 次 检查 多 个 条 件 。 如 果 满 足 这 些 条 件 中 的 任何 一 个 ， 
束 会 执行 代码 ， 例 如 : 


switch (<testVar>) 


{ 
case «comparisonVall»: 
Case «comparisonVal2»: 


«code to execute if <testVar> == <comparisonVall> or 
<testVar> == <comparisonVal2> > 
break; 


注意 ， 这 些 条 件 也 适用 于 default i$). default 语句 不 一 定 要 放 在 比较 操作 列表 的 最 后 ， 还 可 以 把 它 和 case 
语句 放 在 一 起 。 用 break 或 retum 添加 一 个 断 点 ， 可 确保 在 任何 情况 下 ， 该 结构 都 有 一 条 有 效 的 执行 路 径 。 
在 下 面 的 示例 中 ， 将 使 用 switch 语句 ， 根 据 用 尸 为 测试 字符 串 输 入 的 值 ， 将 不 同 字符 串 写 到 控制 台 。 


试 一 试 ” 使 用 switch 语句 : Ch04Ex03\Program.cs 


(1) 在 目录 C:\BeginningCSharp7\Chapter04 中 创建 一 个 新 的 控制 台 应 用 程序 Ch04Ex03。 
(2) 把 以 下 代码 添加 到 Program.cs HF: 


static void Main(string[] args) 
{ 
const string myName = "benjamin"; 
const string niceName = "andrea"; 
const string sillyName - "ploppy"; 
string name; 
WriteLine("What is your name?"); 
name — ReadLine(); 
switch (name.ToLower()) 
{ 
case myName: 
WriteLine ("You have the same name as me!"); 
break; 
case niceName: 
WriteLine("My, what a nice name you have!"); 
break; 
case sillyName: 
WriteLine ("That's a very silly name."); 
break; 
H 
qriteLine($"Hello {name}!"); 
ReadFey () ; 
} 


(3) 执行 代码 ， 输 入 一 个 姓名 ， 结 果 如 图 4-3 所 示 。 


示例 说 明 

这 段 代码 建立 了 3 个 彰 量 字符 串 ， 接 受用 户 输入 的 一 个 字符 串 ， 再 根据 输入 的 字符 串 把 文本 写 到 控制 合 。 
这 里 ， 字 符 串 是 用 户 输入 的 姓名 。 

在 比较 输入 的 姓名 (在 变量 name 中 ) 和 第 量 值 时 ， 首 先 要 用 name.ToLower0O 把 输入 的 姓名 转换 为 小 写 。 
name.ToLower0 是 一 个 标准 命令 ， 可 用 于 处 理 所 有 字符 串 变 量 ， 在 不 能 确定 用 户 输入 的 内 容 时 ， 使 用 它 是 很 方 
便 的 。 使 用 这 种 技术 ， 字 符 串 Benjamin. benJamin. benjamin 等 就 会 与 测试 字符 串 benjamin 匹配 了 。 

switch 语句 尝试 将 输入 的 字 答 串 与 定义 的 当量 值 进行 匹配 ， 如 果 成 功 , 就 会 用 一 条 个 性 化 的 消 奶 问候 用 户 。 
如 果 不 匹 配 ， 则 只 简单 地 问候 用 户 。 
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4.3 ”循环 


循环 就 是 重复 执行 语句 。 这 种 技术 使 用 起 来 非常 方便 ， 因 为 可 以 对 操作 重复 任意 多 次 ( 数 千 次 ， 甚 至 数 百 万 
次 )， 而 不 必 每 次 都 编写 相同 的 代码 。 

举 一 个 简单 例子 ， 下 面 的 代码 计算 一 个 银行 账户 在 10 年 后 的 金额 ,假定 支付 每 年 的 利息 ， 且 该 账户 没有 其 
他 款项 的 存 取 : 


double balance = 1000; 
double interestRate = 1.05; // 5% interest/year 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 
balance *= interestRate; 


将 相同 代码 编写 10 次 很 费时 间 ， 如 果 把 10 年 改 为 其 他 值 ， 驻 会 如 何 ? AM UAE AMS TT FL BUTS S2 
的 次 数 ， 这 是 一 件 多 么 痛 苗 的 事 ! 竺 运 的 是 ， 完 全 不 必 这 样 做 。 使 用 一 个 循环 就 可 以 对 指令 执行 需要 的 次 数 。 

循环 的 另 一 种 重要 关 型 是 一 直 循 环 到 给 定 的 条 件 满 足 为 止 。 这 些 循 环比 上 面 摘 述 的 循环 稍 人 简单 些 ( 但 同样 很 
有 用 )， 所 以 育 先 介绍 这 类 循环 。 


H: H: jH 


4.3.1 do 循环 


do 循环 以 下 述 方式 执行 : HÍT, RET ^ Tdi, URW RA true, WERK 
执行 这 段 代 码 ， 并 重复 这 个 过 程 。 当 测试 结果 为 false 时 ， 就 退出 循环 。 

do 循环 的 结构 如 下 : 

do 

i «code to be looped- 

) while («Test»); 


其 中 ， 计 算 <Test> 会 得 到 一 个 布尔 值 。 


注意 : 
while 语句 之 后 必须 使 用 分 号 。 


例如 ， 使 用 该 结构 可 以 把 从 1 到 10 的 数字 输出 到 一 列 : 


int 1 = 1; 
do 

WriteLine("{O}", i++); 
} while (1 <= 10); 


EE i 的 值 写 到 屏幕 上 后 ， 使 用 后 组 形式 的 ++ 运 算 符 递增 i 的 值 ， 所 以 需要 检查 一 下 i < 一 10， 以 便 把 数字 
10 也 输出 到 控制 合 中 。 

下 例 使 用 这 个 结构 略微 修改 一 下 本 节 前 面 的 代码 。 该 段 代 码 计算 一 个 账户 在 10 年 后 的 余额 。 这 次 使 用 一 
个 循环 ， 根 据 起 始 的 金额 和 固定 利率 ， 计 算 该 账户 的 金额 需要 多 少年 才能 达到 某 个 指定 的 数额 。 


试 一 试 ” 使 用 do 循环 : Ch04Ex04\Program.cs 


(1) 在 目录 C:\BeginningCsharp7\Chapter04 中 创建 一 个 新 的 控制 台 应 用 程序 Ch04Ex04。 
(2) 把 下 述 代码 添加 到 Program.cs 中 : 


static void Main(string[] args) 


{ 
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double balance, interestRate, targetBalance; 

WriteLine ("What is your current balance?") ; 

balance = ToDouble (ReadLine()); 

WriteLine ("What is your current annual interest rate (in %)?"); 
interestRate = 1 + ToDouble(ReadLine()) / 100.0; 
WriteLine("What balance would you like to have?"); 
targetBalance = ToDouble (ReadLine()); 

int totalYears - 0; 


do 

{ 
balance *= interestRate; 
++totalYears; 

} 


while (balance < targetBalance) ; 
WriteLine($"In (totalYears) year((totalYears == 1 ? ""; "s")} " + 
$"you'll have a balance of (balance)."); 
ReadKey () ; 
} 


(3) 执行 代码 ， 输 入 一 些 值 ， 示 例 结果 如 图 4-4 所 示 。 


示例 说 明 
这 段 代码 利用 固定 的 利率 ， 对 年 度 计 算 余 额 的 过 程 重复 必要 的 次 数 ， 直 到 满足 结束 条 件 为 止 。 在 每 次 循环 
中 ， 递 增 一 个 计数 器 变量 ， 就 可 以 确定 需要 多 少年 : 
int totalYears = 0; 
do 
' balance *= interestRate; 
++totalYears; 


while (balance < targetBalance); 
然后 就 可 以 将 这 个 计数 器 变量 用 作 输 出 结果 的 一 部 分 : 
WriteLine($"In {totalYears} 


year{ (totalYears — 1 ? "": "s")) 
you'll have a balance of {balance}."); 


注意 : 
这 可 能 是 ?: (三 元 ) 运 算 符 最 常见 的 用 法 了 一 一 用 最 少 的 代码 有 条 件 地 格式 化 文本 。 这 里 ， 如 果 totalYears 不 
每 于 1， 就 在 yea 后 面 输出 一 个 s. 


(AIX EUS SER, SE P HoRSVP T SHR MNT, MARMUR 4-5 所 示 。 


do 循环 至 少 执行 一 次 。 有 时 (如 这 个 示例 ) 这 并 不 是 很 理想 。 当 然 ， 可 以 添加 一 条 让 语句 ， 


int totalYears = 0; 
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if (balance < targetBalance) 
{ 
do 
{ 
balance *= interestRate; 
++totalYears; 
} 
while (balance < targetBalance) ; 
} 
WriteLine($"In {totalYears} year[(totalYears == 1 ? ""; "s")} ”十 
s"you'll have a balance of {balance}."); 


XX SE ATC TAHA Y ARTE. BEARER TT REH while 循环 。 


4.32 while 循环 


while 循环 非常 类 似 于 do 循环 , 但 有 一 个 重要 的 区 别 : while 循环 中 的 布尔 测试 在 循环 开始 时 进行 ,而 不 是 
最 后 进行 。 如 条 测试 结 条 为 包 lse， 就 不 会 执行 循环 。 程 序 的 执行 会 直接 跳 苇 到 循环 之 后 的 代码 。 

按 下 述 方式 指定 while 循环 : 

while (<Test>) 

| «code to be looped> 

while 循环 的 使 用 方式 几乎 与 do 循环 完全 相同 ， 例 如 : 


int i = 1; 
while (i <= 10) 
{ 
WriteLine ($"{i+4+}"); 


} 
这 段 代 码 的 执行 结果 与 前 面 的 do 循环 相同 ， 它 在 一 列 中 输出 从 1 到 10 的 数字 。 下 面 使 用 while 循环 修改 
上 一 个 示例 。 


试 一 试 ” 使 用 while 循环 : Ch04Ex05\Program.cs 


(1) 在 目录 C:\BeginningCSharp7\Chapter04 中 创建 一 个 新 的 控制 台 应 用 程序 Ch04Ex05。 
(2) 修改 代码 ， 如 下 所 示 ( 使 用 Ch04Ex04 中 的 代码 作为 起 点 ， 记 住 ， 要 删除 原来 do 循环 最 后 的 while 


语句 ) 
static void Main(string[] args) 
{ 
double balance, interestRate, targetBalance; 
WriteLine ("What is your current balance?"); 
balance = ToDouble (ReadLine()); 
WriteLine ("What is your current annual interest rate (in $)?"); 
interestRate = 1 + ToDouble(ReadLine()) / 100.0; 
WriteLine ("What balance would you like to have?"); 
targetBalance = ToDouble (ReadLine()); 
int totalYears - 0; 
4hile (balance < targetBalance) 
{ 
balance *= interestRate; 
++totalYears; 
WriteLine(S"In {totalYears} year{ (totalYears I 2 c WS") GS 
5"you'll have a balance of {balance}."); 
if (totalYears == 0) 
WriteLine( 
"TO be honest, you really didn't need to use this calculator."); 
ReadKey () ; 
} 


(3) 再 次 执行 代码 ， 但 这 次 使 用 少 于 起 始 余额 的 目标 余额 ， 如 图 4-6 所 示 。 
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示例 说 明 

这 段 代码 只 是 把 do 循环 改 为 while 循环 ， 就 解决 了 上 个 示例 中 的 问题 。 把 布尔 测试 移 到 开头 处 ， 就 考虑 了 不 
需要 执行 循环 的 情况 ， 可 以 直接 跳 转 到 输出 结果 。 

当然 ， 对 于 这 种 情况 还 有 一 个 解决 方案 。 例 如 ， 可 以 检查 用 户 输入 ， 确 保 目标 余额 大 于 起 始 余额 。 此 
时 ， 可 以 把 用 户 输入 部 分 放 在 循环 中 ， 如 下 所 示 ; 


WriteLine("What balance would you like to have?"); 
do 
{ 

targetBalance = ToDouble (ReadLine()); 

if (targetBalance «- balance) 

WriteLine("You must enter an amount greater than " + 
"your current balance!\nPlease enter another value."); 

) 
while (targetBalance <= balance); 


这 将 拒绝 接受 无 意义 的 值 ， 得 到 如 图 4-7 所 示 的 结果 。 


4-7 


在 设计 应 用 程序 时 ， 用 户 输入 的 有 效 性 检查 是 一 个 很 重要 的 主题 ， 本 书 将 列举 更 多 这 方面 的 示例 。 


433 for 循环 


本 章 介 绍 的 最 后 一 类 循环 是 for 循环 。 这 类 循环 可 以 执行 指定 的 次 数 ， 并 维护 它 目 己 的 计数 项 。 要 定义 for 
循环 ， 需 要 下 列 信息 : 

e 初 妈 化 计数 右 变 量 的 一 个 起 始 值 。 

e 继续 循环 的 条 件 ， 应 涉及 计数 器 变量 。 

e 在 每 次 循环 的 最 后 ， 对 计数 器 变量 执行 一 个 操作 。 

例如 ， 如 果 要 在 循环 中 ， 使 计数 器 从 1 递增 到 10， 递 增 量 为 1， 则 起 始 值 为 1， 条 件 是 计数 器 小 于 或 等 于 
10， 在 每 次 循环 的 最 后 ， 要 执行 的 操作 是 给 计数 右 加 1。 

这 些 信息 必须 放 在 for 循环 的 结构 中 ， 如 下 所 示 : 

for (<initialization>; <condition>; <operation>) 

<code to loop> 

} 

它 的 工作 方式 与 下 述 while 循环 完全 相同 : 
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<initialization> 
while (<condition>) 


{ 


«code to loop- 

«operation» 
} 
前 面 使 用 do 循环 和 while 循环 输出 了 从 1 到 10 的 数字 。 下 面 看 看 如 何 使 用 for 循环 完成 这 个 任务 ; 
int i; 


for (1 = 1; i <= 10; +i) 


WriteLine($"[i]"); 


iA ee xmi CNN SSR 1. TERROR ee 1。 在 每 次 循环 过 程 中 ， 把 i 的 值 写 到 
la. 

注意 ， 当 i 的 值 为 11 时， 将 执行 循环 后 面 的 代码 。 这 是 因为 在 1 等 于 10 的 循环 末尾 ，i 会 递增 为 11。 这 是 
在 测试 条 件 i1<= 10 之 前 发 生 的 ， 此 时 循环 结束 。 与 while 循环 一 样 ， 在 第 一 次 执行 前 ， 只 在 条 件 计算 为 true 时 
AAMT for 循环 ， 所 以 可 能 根本 惑 不 会 执行 循环 中 的 代码 。 

最 后 注意 ， 可 将 计数 器 变量 声明 为 for 语句 的 一 部 分 ， 重 新 编写 上 述 代 码 ， 如 下 所 示 : 

for (int i = 1; i <= 10; ++i) 

WriteLine($"[i]"); 

} 

{AO RRL, BEAN ETE TE P BE RH EE 1 (BLS 6 3: 62 节 “ 变 量 的 作用 域 ”)。 


4.3.4 循环 的 中 断 


有 了 时 需要 更 精细 地 控制 循环 代码 的 处 理 。C# 为 此 提供 了 以 下 命令 : 
e break 一 一 并 即 终 止 循环 。 
e continue 一 一 江 即 终止 当前 的 循环 (继续 执行 下 一 次 循环 )。 
e retum 一 一 跳出 循环 及 包含 该 循环 的 图 数 ( 参 见 第 6 章 )。 
break 命令 可 退出 循环 ， 继 续 执 行 循环 后 面 的 第 一 行 代码 ， 例 如 : 
while (1 <= 10) 
if (i == 6) 
break; 
WriteLine ($"{i++}"); 


} 
这 段 代 码 输 出 数字 1 到 5， 因 为 break 命令 在 i 的 值 为 6 时 退出 循环 。 
continue 仅 终止 当前 和 迭代， 而 不 是 整个 循环 ， 例 如 : 


int i: 
for (i = 1; i <= 10; i++) 
{ 
if ((i $ 2) = 0) 
continue; 
WriteLine (i); 
} 


在 上 面 的 示例 中 ， 只 要 15 EL 2 的 余数 是 0，continue HA MAIER AAR, MURERE 3. 5. 7 
和 9。 
4.3.5 ”无限 循环 


在 代码 编写 错误 或 故意 进行 设计 时 ， 可 以 定义 永 不 终止 的 循环 ， 即 所 谓 的 无 限 循环 Gnfinite loop)。 例 如 ， 
下 面 的 代码 残 是 无 限 循环 的 一 个 简单 例子 : 


while (true) 
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// code in loop 


| 
有 时 这 种 代码 也 是 有 用 的 ， 而 且 使 用 break 语句 或 者 手工 使 用 Windows 13E FR di ze n] LGB CENA 
环 。 但 当 音 外 出 现 这 种 情形 时 ， 就 会 出 问题 。 考 虑 下 面 的 循环 ， 它 与 上 一 市 中 的 for 循环 非常 类 似 : 


int 1 = 1; 
while (1 <= 10) 


{ 
if ((i $ 2) = 0) 
continue; 
WriteLine ($"{1++}"); 
} 


TENE, i 是 在 循环 的 最 后 一 行 代码 ( 即 continue 语句 后 的 那 条 语句 ) 执 行 完 后 才 递 增 的 。 如 果 程 序 执行 到 
continue 语句 (此 时 i 7J 2), 程序 会 用 相同 的 i 值 进行 下 一 个 循环 , 然后 测试 这 个 i 值 , 继续 循环 , 一 直 这 样 下 去 。 
这 就 冻结 了 应 用 程序 。 注意 ， 仍 可 采用 一 般 方 式 退 出 已 冻结 的 应 用 程序 ， 所 以 不 必 重 新 局 动 计算 机 。 


4.4 习题 


(D) 如 果 两 个 整数 存储 在 变量 varl 和 var2 中 , 该 进行 什么 样 的 布尔 测试 ， 可 会 看 其 中 的 一 个 (但 不 是 两 个 ) 
EE KF 10? 
(2) 编写 一 个 应 用 程序 ， 其 中 包含 习题 (1) 中 的 逻辑 ， 要 求 用 尸 输入 两 个 数字 ， 并 显示 它们 ， 但 拒绝 接受 两 
个 数字 都 大 于 10 的 情况 ， 并 要 求 用 户 重 新 输入 。 
(3) 下 面 的 代码 存在 什么 错误 ? 
i if (i $ 2) = 0) 
continue; 


WriteLine (i); 


} 
附录 A 给 出 了 习题 答案 。 
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主 题 要 A 
布尔 逻辑 使 用 布尔 值 (roe 和 色 lse) 计 算 条 件 。 布 尔 运 算 符 用 于 比较 数值 ， 人 返回 布尔 结果 。 一 些 布尔 运算 得 也 用 于 


布尔 逻辑 
i 对 数值 的 底层 位 结构 执行 按 位 操作 ， 还 有 一 些 专门 的 按 位 运算 符 
m 可 使 用 布尔 逻辑 控制 程序 流 。 计 算 结 果 为 布尔 值 的 表达 式 可 用 于 确定 是 否 执行 某 个 代码 块 ， 可 以 使 用 证 语句 


或 ?:( 三 元 ) 运 算 符 进 行 简 单 的 分 支 ， 或 者 使 用 switch 语句 同时 检查 多 个 条 件 

循环 允许 根据 指定 的 条 件 多 次 执行 代码 块 。 使 用 do 循环 和 while 循环 可 在 布尔 表达 式 为 true 时 执行 代码 ， 使 用 
循环 for 循环 可 在 循环 代码 中 包含 一 个 计数 器 。 循 环 可 以 使 用 continue 中 断 当 前 的 迭代 ,或 者 使 用 break 完全 中 断 。 一 

些 循环 只 能 在 用 户 强制 中 断 时 结束 ， 这 些 循环 称 为 无 限 循环 


ARBAB: 


e WERA BEIT pA UA Se TR 
e ”如 何 创建 和 使 用 枚 举 类 型 

e ”如 何 创 建 和 使 用 结构 类 型 

e 如 何 创建 和 使 用 数组 

e 如何 处 理 字符 串 值 

本 草 源 代码 下 载 : 


本 章 源 代码 可 以 通过 本 书 合作 站 点 Wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapter05 文件 夹 中 并 已 根据 本 章 示 例 的 
名 称 单独 命名 . 


前 面 介绍 了 有 关 C# 语 言 的 一 些 内 容 ， 现 在 将 回顾 和 讨论 与 变量 相关 的 其 他 一 些 较 复杂 的 主题 。 

首先 讨论 类 型 转换 ， 即 把 值 从 一 种 类 型 转换 为 另 一 种 类 型 。 前 面 已 经 描述 了 其 中 一 些 信息 ， 这 里 则 要 正式 
讨论 。 掌 握 这 个 主题 可 以 更 好 地 理解 表达 式 中 (有 意 或 无 意 地 ) 混 合 使 用 类 型 时 会 发 生 什么 ， 更 好 地 控制 处 理 数 
据 的 方式 。 这 有 助 于 理 顺 代码 ， 和 避免 引 起 不 必要 的 误解 。 

接着 阐述 另 一 些 类 型 的 变量 ， 

e 枚 举 一 一 一 种 变量 类 型 ， 用 户 定义 了 一 组 可 能 的 离散 值 ， 这 些 值 可 用 人 们 能 理解 的 方式 使 用 。 

。 结构 一 -一 种 合成 的 变量 类 型 ， 由 用 户 定义 的 一 组 其 他 变量 类 型 组 成 。 

e 数组 一 -包含 一 种 类 型 的 多 个 变量 ， 人 允许 以 索引 方式 访问 各 个 值 。 

这 些 类 型 比 前 面 使 用 的 简单 类 型 复杂 一 些 ， 但 可 以 使 工作 更 容易 完成 。 最 后 ， 学 习 另 一 个 与 字符 串 相关 的 
基本 字符 串 处 理 。 


5.1 类 型 转换 


本 书 前 面 说 过 ， 无 论 是 什么 类 型 ， 所 有 数据 部 是 一 系列 的 位 ， 即 一 系列 0 和 1。 变 量 的 含义 是 通过 解释 这 
些 数据 的 方式 来 确定 的 。 最 简单 的 示例 是 char 类 型 ， 这 种 类 型 用 一 个 数字 表示 Unicode 字符 集中 的 一 个 字符 。 
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实际 上 ， 这 个 数字 与 ushort 的 存储 方式 完全 相同 一 一 它们 都 存储 0 和 65 535 之 间 的 数字 。 
但 一 般 情 况 下 ， 不 同类 型 的 变量 使 用 不 同 的 模式 来 表示 数据 。 这 意味 着 ， 即 使 可 以 把 一 系列 的 位 从 一 种 类 
型 的 变量 移动 到 男 一 种 类 型 的 变量 中 (也 许 它们 占用 的 存储 空间 相同 , 也 许 目标 类 型 有 足够 的 存储 空间 包含 所 有 
的 源 数 据 位 )， 结 果 也 可 能 与 期 望 的 不 同 。 
因此 ， 需 要 对 数据 进行 类 型 转换 ， 而 不 是 将 数据 位 从 一 个 变量 一 对 一 映射 到 另 一 个 变量 。 交 型 转换 采用 以 
e ENR: 从 类 型 A 到 类 型 B 的 转换 可 在 所 有 情况 下 进行 ， 执 行 转换 的 规则 非常 简单 ， 可 以 让 编 详 需 
执行 转换 。 
e 显 式 转换 : 从 类 型 A 到 类 型 B 的 转换 只 能 在 茶 些 情况 下 进行 ， 转 换 规 则 比较 复 灯 ， 应 进行 茶 种 类 型 的 
额外 处 理 。 


5.1.1 隐 式 转换 
总 式 转换 不 需要 做 任何 工作 ， 也 不 需要 另外 编写 代码 。 考 虑 下 面 的 代码 : 


varl = var?2; 


如 果 var2 的 类 型 可 以 隐 式 地 转换 为 varl WRAY, ARMA A) RBS. XPS ee RAE tu] 
能 相同 ， 此 时 融 不 需要 隐 式 转换 。 例 如 ，ushort 和 char 的 值 是 可 以 互 换 的 ， 因 为 它们 都 可 以 存储 0 和 65 535 
之 则 的 数字 ， 在 这 两 种 类 型 之 间 可 以 进行 隐 式 转换 ， 如 下 面 的 代码 所 示 : 


ushort destinationVar; 

char sourceVar = 'a'; 

destinationVar - sourceVar; 

WriteLine ($"sourceVar val: {sourceVar}"); 

WriteLine ($"destinationVar val: {destinationVar}"); 


这 里 存储 在 source Var 中 的 值 放 在 destinationVar 中 。 在 用 两 个 WriteLineO0 命 令 输 出 变量 时 ,得 到 如 下 结果 : 


sourceVar Val: a 
destinationVar val: 97 


即使 两 个 变量 存储 的 信息 相同 ， 使 用 不 同 的 类 型 解释 它们 时 ， 方 式 也 是 不 同 的 。 
简单 类 型 有 许多 隐 式 转换 ，bool 和 string 没有 隐 式 转换 ， 但 数值 类 型 有 一 些 隐 式 转换 。 表 5-1 列 出 了 编译 
器 可 以 隐 式 执行 的 数值 转换 ( 记 住 ，char 存储 的 是 数值 ， 所 以 char 被 当 作 数值 类 型 )。 


表 5-1 隐 式 数值 转换 


类 型 可 以 安全 地 转换 为 
byte short, ushort, int, uint, long, ulong, float, double, decimal 
sbyte short, int, long, float, double, decimal 
short int, long. float. double, decimal 
ushort int, uint, long, ulone, float, double, decimal 
int long, float, double. decimal 
uint long. ulong. float. double. decimal 
long float, double, decimal 
ulong float, double, decimal 
float double 
char ushort, int, uint, long, ulong, float, double, decimal 

不 必 担 心 一 一 不 需要 记 住 这 个 表格 ， 因 为 很 容易 看 出 编译 器 可 以 执行 哪些 隐 式 转换 。 第 3 章 中 的 表 3-1. 


X 3-2 MR 3-3 列 出 了 每 种 简单 数字 类 型 的 取 值 范围 。 这 些 类 型 的 隐 式 转换 规则 是 : 任何 类 型 A， 只 要 其 取 值 
范围 完全 包含 在 类 型 B 的 取 值 范围 内 ， 就 可 以 隐 式 转换 为 关 型 B. 
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其 原因 是 很 简单 的 。 如 果 要 把 一 个 值 放 在 变量 中 , 而 该 值 超出 了 变量 的 取 值 范围 , 就 会 出 问题 。 例 如 ，short 
类 型 的 变量 可 以 存储 0 一 32 767 的 数字 ， 而 byte 可 以 存储 的 最 大 值 是 255， 所 以 如 果 要 把 short 值 转换 为 byte 值 ， 
就 会 出 问题 。 如 果 short 包含 的 值 在 256 和 32 767 之 间 ， 相 应 数值 就 不 能 放 在 byte 中 。 

但 是 ， 如 果 short 类 型 变量 中 的 值 小 于 255， 就 应 能 转换 这 个 值 吗 ? 答案 是 可 以 。 具 体 而 言 ， 虽 然 可 以 , 但 
必须 使 用 显 式 转换 。 执 行 显 式 转换 有 点 类 似 于 “我 已 经 知道 你 对 我 这 么 做 提出 了 警告 ， 但 我 将 对 其 后 果 负 责 ”。 


512 显 式 转换 


顾 名 忠 义 ， 在 明确 要 求 编 详 艺 把 数值 从 一 种 数据 类 型 转换 为 九 一 种 数据 类 型 时 ， 就 是 在 执行 显 式 转换 。 因 
此 ， 这 需要 男 外 编写 代码 ， 代 人 码 的 格式 因 转 换 方法 而 异 。 在 学 习 显 式 转换 代码 前 ， 首 先 分 析 如 果 不 添加 任何 显 
式 转换 代码 ， 会 及 生 什么 情况 。 

例如 ， 下 面 对 上 一 节 的 代码 进行 修改 ， 试 看 把 short 值 转换 为 byte 类 型 : 


byte destinationVar; 

short sourceVar - 7; 

destinationVar = sourceVar; 

WriteLine ($"sourceVar val: {sourceVar}"); 

WriteLine ($"destinationVar val: {destinationVar}"); 


如 果 编 详 这 段 代 码 ， 束 会 产生 如 下 错误 : 


Cannot implicitly convert type 'short' to 'byte'. An explicit conversion exists 
(are you missing a cast?) 


为 成 功 编译 这 段 代 码 , 需要 添加 代码 , 进行 显 式 转换 。 最 简单 的 方式 是 把 short 变量 强制 转换 为 byte 类 型 (如 
上 述 错 误 字 符 串 所 建议 )。 强 制 转换 束 是 强迫 数据 从 一 种 类型 转换 为 为 一 种 类 型 ， 其 语法 比较 简单 : 


(<destinationType>) <sourceVar> 


BORE <sourceVar>"F Be fh «destination Type» 2378 , 


注意 : 
这 种 转换 方式 只 在 某 些 情况 下 可 行 。 彼 此 间 几 乎 没有 什么 关系 的 类 型 或 根本 没关系 的 类 型 不 能 进行 强制 


因此 可 以 使 用 这 个 语法 修改 示例 ， 把 short 类 型 强制 转换 为 byte RA: 


byte destinationVar; 

short sourceVar - 7; 

destinationVar - (byte)sourceVar; 

WriteLine ($"sourceVar val: [sourceVar]"); 

WriteLine ($"destinationVar val: [destinationVar]"); 


得 到 如 下 结果 : 


sourceVar val: 7 
destinationVar val: 7 


在 试图 把 一 个 值 强制 转换 为 不 兼容 的 变量 类 型 时 ， 会 及 生 什么 呢 ? 以 整数 为 例 ， 不 能 把 一 个 大 整数 放 到 一 
个 太 小 的 数值 类 型 中 。 按 如 下 所 示 修 改 代码 就 能 证 明 这 一 点 : 


byte destinationVar; 

short sourceVar - 281; 

destinationVar - (byte)sourceVar; 

WriteLine ($"sourceVar val: [sourceVar]"); 

WriteLine ($"destinationVar val: {destinationVar}"); 


结果 如 下 : 


sourceVar val: 281 
destinationVar val: 25 


发 生 了 什么 ? 看 看 这 两 个 数字 的 二 进 制 表示 ， 以 及 可 以 存储 在 byte 中 的 最 大 值 255: 


281 = 100011001 
25 = 000011001 
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255 = 011111111 

可 以 看 出 ， 源 数据 的 最 左边 一 位 丢失 了 。 这 会 引发 一 个 问题 ， 如 何 确定 数据 是 何 时 丢失 的 ? 显然 ， 当 需要 
显 式 地 把 一 种 数据 类 型 半 换 为 男 一 种 数据 类 型 时 ， 最 好 能 够 了 解 是 人 否 有 数据 丢失 的 情况 。 如 果 不 知 道 这 些 ， 右 
会 及 生 严 重 问题 。 例 如 ， 财 务 应 用 程序 或 确定 火 租 飞 往 月 球 轨道 的 应 用 程序 。 

一 种 方式 是 检查 源 变量 的 值 ， 将 它 与 目标 变量 的 取 值 范围 进行 比较 。 还 有 另 一 种 技术 ， 融 是 迫使 系统 特别 
注意 运行 期 间 的 转换 。 在 将 一 个 值 放 在 一 个 变量 中 时 ， 如 果 该 值 过 大 ， 不 能 放 在 该 类 型 的 变量 中 ， 融 会 导致 省 
di. IX ne te Ft o 

对 于 为 表达 式 设置 所 谓 的 洲 出 检查 上 下 文 ， 需 要 用 到 两 个 关键 字 一 一 checked 和 unchecked。 按 下 述 方式 使 
用 这 两 个 关键 字 : 


checked (<expression>) 
unchecked (<expression>) 


下 面 对 上 一 个 示例 进行 溢出 检查 ; 


byte destinationVar; 

short sourceVar = 281; 

destinationVar = checked( (byte) sourceVar); 
WriteLine ($"sourceVar val: [sourceVar]"); 

WriteLine ($"destinationVar val: {destinationVar}"); 


执行 这 段 代码 时 ， 程 序 会 朋 尝 ， 并 显示 如 图 5-1 所 示 的 错误 信息 (在 OverflowCheck 项 目 中 纺 详 这 段 代 码 )。 
static void Main(string[] args) 


{ 


byte destinationVar; 


short sourceVar - 281; 

destinationVa 

//destinationVar = unchecked((byte)sourceVar); 

Writeline($"sourceVar val: {sa Exception Unhandled = x 
WriteLine($"destinationVar val: 

ReadLine(); System.OverflowException: ‘Arithmetic operation resulted in an overflow.’ 


Name Value 
4 € Sexception ("Arithmetic operation resulted in an overflow."] 
b JM Data [System.Collections.ListDictionaryInternal) 
# HResult , 2146233066 
J* HelpLink null 
b Exception Se b # InnerException muli 
上 Message "Anthmetic operation resulted in an overflow." Q, =| 
J* Source "OverflowCheckingContext" q ejs 
# StackTrace " at OverflowtCheckingContext.Program.Main(String[] args) in C\\Bec & "| 
P # Targetsite [Void Main(System.String[T)] 
b fg Static members 
b @ Non-Public members 


View Details 


图 5-1 


但 在 这 段 代 码 中 ， 如 果 用 unchecked #4 checked， 就 会 得 到 与 以 前 同样 的 结果 ， 不 会 出 现 错误 。 这 与 前 面 
的 默认 做 法 是 一 样 的 。 

也 可 以 配置 应 用 程序 ， 让 这 种 类 型 的 表达 式 都 和 包含 checked 关键 字 一 样 ， 除非 表 达 式 明确 使 用 unchecked 
关键 字 ( 换 言 之 ， 可 以 改变 游 出 检查 的 默认 设置 )。 为 此 ， 应 修改 项 目的 属性 : 右 击 Solution Explorer 窗口 中 的 项 
目 ， 选 择 Properties 选项 。 单 击 窗口 左边 的 Build， 打 开 Build 设置 。 

要 修改 的 属性 是 一 个 Advanced 设置 ,所 以 单 击 Advanced 按钮 .在 打开 的 对 话 框 中 , 选中 Check for arithmetic 
overflow/underflow 选项 ， 如 图 5-2 Prax. BRU dé Pak PBA, BORER VEE checked 行为 。 这 
^x B. AY EST Ee RAITER ER FE, DIETAS BESSER LE 
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General 


Lanquage Version: ‘default Y 
internal Compiler Error Reporting: [prompt v 


Check for arithmetic overflow/underflow 


Output — —— 
Debug Info: 


File Alignment 


DLL Base Address: (0x00400000 


5-2 


51.3 使 用 Convert 命令 进行 显 式 转换 


前 面 章节 中 的 许多 “ 试 一 试 ” 示 例 中 使 用 的 显 式 类 型 转换 ， 这 与 本 章 前 面 的 示例 有 一 些 区 别 。 前 面 使 用 
ToDouble0 等 命令 把 字符 串 值 转换 为 数值 ， 显 然 ， 这 种 方式 并 不 适用 于 所 有 字符 串 。 
例如 ， 如 果 使 用 ToDouble0 把 Number 字符 串 转 换 为 double 值 ， 在 执行 代码 时 ， 将 看 到 如 图 5-3 所 示 的 对 
static void Main(string[] args) 
double number = ToDouble("Number"); 65 
et 
//destinationVar = unchecked( (by 


WriteLine($"sourceVar val: {sour 
WriteLline(i"destinationVar val: 


Add Watch 


System.FormatException: ‘Input string was not in a correct format’ 


Name Value Type 
4 4 Sexception "Input string was not in a correct format | | System.F 
b # Data (System. Collections.ListDictionaryInternal) System.C 
# HResult -2146233033 | int 
# HelpLink null | string 
b Æ InnerException null System.E 
J* Message "Input string was not in a correct format." =| string 
J Source "mscorlib" a = strin 
* StackTrace - at System.Number.ParseDouble(String value, NumberStyles option: 以 =| string 
> # TargetSite [Double ParseDouble(System.String, System.GlobalizationNumberStyles, S System.R 
b “ Static members | 
b @ Non-Public members — 


5-3 


可 以 看 出 ， 执 行 失败 。 为 成 功 执行 此 类 转换 ， 所 提供 的 字符 串 必 须 是 数值 的 有 效 表 达 方 式 ， 该 数 还 必须 是 
不 会 派出 的 数 。 数 值 的 有 效 表达 方式 是 : 首 移 是 一 个 可 选 竺 号 (加 号 或 减 号 )， 然 后 是 0 位 或 多 位 数字 ， 一 个 可 
选 的 句点 后 跟 一 位 或 多 位 数字 ， 接 痢 是 一 个 可 选 的 e 或 耻 ， 后 跟 一 个 可 选 竺 号 和 一 位 或 多 位 数字 ， 除 了 还 可 能 
有 空格 (在 这 个 序列 之 前 或 之 后 )， 不 能 有 其 他 字符 。 利 用 这 些 可 选 的 额外 数据 ， 可 将 - 12451e - 24 这 样 复杂 的 字 
从 串 识 别 为 数值 。 

对 于 这 些 转换 要 注意 的 一 个 重要 问题 是 ,它们 总 是 要 进行 洲 出 检查 ，checked 和 unchecked 关键 字 以 及 项 目 
属性 设置 不 起 作用 。 

下 面 的 示例 包括 本 节 介 绍 的 许多 转换 类 型 。 它 声明 和 初始 化 许多 不 同类 型 的 变量 ， 再 在 它们 之 间 进 行 隐 陈 
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Dill 


试 一 试 ” 类 型 转换 实践 : ChO5Ex01\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter05 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch05Ex01。 
(2) 把 下 述 代码 添加 到 Program.cs "(SE icf using static System.Console 和 using static System.Convert 
语句 添加 到 该 程序 项 部 的 引用 列表 中 ): 


static void Main(string[] args) 

{ 
Short shortResult, shortVal = 4 
int integerVal = 67; 
long  longResult; 
float floatVal = 10.5F; 
double doubleResult, doubleVal 
string stringResult, stringVal 
bool boolVal = true; 
WriteLine ("Variable Conversion Examples\n"); 
doubleResult = floatVal * shortVal; 
WriteLine($"Implicit, -> double: [floatVal] * {shortVal} -> { doubleResult }"); 
shortResult - (short)floatVal; 
WriteLine($"Explicit, -> short: {floatVal} -> {shortResult}"); 
stringResult = Convert.ToString(boolVal) + 

Convert.ToString (doubleVal); 
WriteLine($"Explicit, -> string: \"{boolVal}\" + \"{doubleVal}\" -> " + 
S"{stringResult}"); 

longResult = integerVal + ToInt64(stringVal); 
WriteLine($"Mixed, -> long: {integerVal} + {stringVal} -> {longResult}"); 
ReadKey () ; 

} 


(3) 执行 代码 ， 结 果 如 图 5-4 所 示 。 


99.999; 
"1 ]J d- 


示例 说 明 

这 个 示例 包含 前 面 介绍 的 所 有 转换 类 型 ， 既 有 像 前 面 简短 代码 示例 中 的 简单 赋值 ， 也 有 在 表达 式 中 进行 的 
转换 。 必 须 考虑 这 两 种 情况 ， 因 为 每 个 非 一 元 运算 符 的 处 理 都 可 能 要 进行 类 型 转换 ， 而 不 仅 是 赋值 运算 符 。 
例如 : 


shortVal * floatVal 


其 中 把 一 个 short 值 与 一 个 float 值 相 乘 。 在 这 样 的 指令 中 ， 没 有 指定 显 式 转换 ， 所 以 如 有 可 能 ， 就 会 进行 
隐 式 转换 。 在 这 个 示例 中 ， 唯 一 有 意义 的 隐 式 转换 是 把 short 值 转换 为 float 值 (因为 把 float 值 转换 为 short 值 需 
要 进行 显 式 转换 )， 所 以 这 里 将 使 用 隐 式 转换 。 

不 过 ， 也 可 以 覆盖 这 种 行为 ， 如 下 所 示 ; 


shortVal * (short) floatVal 


注意 : 

有 趣 的 是 ， 两 个 short 值 相 乘 的 结果 并 不 会 返回 一 个 short 值 。 因 为 这 个 操作 的 结果 很 可 能 大 于 32 767( 这 是 
short 类 型 可 以 存储 的 最 大 值 )， 所 以 这 个 操作 的 结果 实际 上 是 int 值 。 

这 个 转换 过 程 初 看 起 来 比较 复杂 ， 但 只 要 按照 运算 符 的 优先 级 把 表达 式 分 解 为 不 同 的 部 分 ， 就 可 以 弄 清 楚 


这 个 过 程 。 
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5.2 复杂 的 变量 类 型 
除了 这 些 简单 的 变量 类 型 外 ，C# 还 提供 了 3 个 较 复 杂 ( 但 非常 有 用 ) 的 变量 ， 枚 举 、 结 构 和 数组 。 
521 T3 


本 书 迄今 介绍 的 每 种 类 型 ( 除 string 外 ) 都 有 明确 的 取 值 范围 。 诚然 , 有 些 类 型 (如 double) 的 取 值 范围 非常 大 ， 
可 以 看 成 是 连续 的 ， 但 它们 仍 是 一 个 固定 集合 。 最 简单 的 示例 是 bool 类 型 ， 它 只 能 取 两 个 值 ，true 或 false. 

有 时 希望 变量 取 的 是 一 个 固定 集合 中 的 值 。 例 如 ， 让 orientation 类 型 可 以 存储 north. south. east 或 west 
中 的 一 个 值 。 

此 时 可 以 使 用 枚 举 类 型 。 枚 举 可 以 完成 这 个 orientation 类 型 的 任务 : 它们 允许 定义 一 个 类 型 ， 其 取 值 范围 
是 用 户 提供 的 值 的 有 限 集合 。 所 以 ， 需 要 创建 自己 的 枚 举 类 型 orientation， 它 可 以 从 上 述 4 个 值 中 取 一 个 值 。 

注意 有 一 个 附加 步骤 -一 不 是 仅 声明 一 个 给 定 类 型 的 变量 ， 而 是 声明 和 描述 一 个 用 户 定义 的 类 型 ， 再 声明 
这 个 新 类 型 的 变量 。 

定义 枚 举 

可 以 用 enum 关键 字 定义 枚 举 ， 如 下 所 示 : 


enum <typeName> 


<valuel>, 
<value2>, 
<value3>, 


<valueN> 


} 

接 独 声明 这 个 新 类 型 的 变量 : 
<typeName> <varName>; 

并 赋值 : 


<varName> = <typeName>.<value>; 


MAME H—TAEAR ADR TAG. POERA BY ER BEM AB TF AAEE RE “ME, BRUT PIOS 
7j int. FERS APSA, mu] Use EAA 

enum «typeName» : <underlyingType> 

l <valuel>, 


<vValue2>, 
<value3>, 


l <valueN> 

BLAS HY Zi AN SSA n] LE byte, sbyte. short. ushort. int, uint, long 和 ulong。 

默认 情况 下 ， 每 个 值 都 会 根据 定义 的 顺序 (从 0 开始 )， 被 目 动 赋予 对 应 的 基本 类 型 值 。 这 意味 着 <valuel> 
的 值 是 0，<value2> 的 值 是 1，<value3> 的 值 是 2， 等 等 。 可 以 重 写 这 个 赋值 过 程 : 使 用 三 运算 符 ， 指 定 每 个 枚 
举 的 实际 值 ; 

enum <typeName> : <underlyingType> 

<valuel> = <actualVall>, 


<value2> = <actualVal2>, 
<value3> = <actualVal3>, 


<valueN> = <actualValN> 


| 
还 可 以 使 用 一 个 值 作 为 另 一 个 枚 举 的 基础 值 ， 为 多 个 枚 举 指定 相同 的 值 : 


enum <typeName> : <underlyingType> 
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{ 
<valuel> = <actualVall>, 
<value2> = <valuel>, 
<value3>, 


«valueN» = <actualValN> 


} 

未 赋值 的 任何 值 都 会 目 动 获得 一 个 初始 值 ， 这 里 使 用 的 值 是 从 比 上 一 个 明确 声明 的 值 大 1 开始 的 序列 。 例 
在 上 面 的 代码 中 ，<value3> 的 值 是 <valuel> + 1. 

注意 这 可 能 会 产生 预料 不 到 的 问题 ， 在 一 个 定义 (如 <value2> = <valuel>) 后 指定 的 值 可 能 与 其 他 值 相 同 。 例 
在 下 面 的 代码 中 ，<value4> 的 值 与 <value2> 的 值 相同 ; 


enum <typeName> : <underlyingType> 


{ 
<valuel> = <actualVall>, 
«value2-, 
<value3> = <valuel>, 
<value4>, 
<valueN> = <actualValN> 
} 


当然 ， 如 果 这 正 是 希望 的 结果 ， 代 码 就 是 正确 的 。 还 要 注意 ， 以 循环 方式 赋值 可 能 会 产生 错误 ， 例 如 : 


enum <typeName> : <underlyingType> 
{ 

<valuel> = <value2>, 

«value2» = <valuel> 


} 
下 面 看 一 个 示例 。 其 代码 定义 了 一 个 枚 举 orientation， 然 后 演示 了 它 的 用 法 。 


试 一 试 ”使 用 枚 举 : Ch05Ex02\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter05 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch05Ex02。 
(2) 把 下 列 代码 添加 到 Program.cs "P: 


using static System.Console; 
using static System.Convert; 


namespace Ch05Ex02 


{ 
enum orientation : byte 
{ 
north = 1, 
south = 2, 
east = 3, 
west = 4 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
orientation myDirection = orientation.north; 
WriteLine ($"myDirection = {myDirection}"); 
ReadkKey () ; 
} 
} 
} 


(3) 运行 应 用 程序 ， 应 得 到 如 图 5-5 所 示 的 输出 结果 。 


图 5-5 


(4) 退出 应 用 程序 ， 并 修改 Main0 方 法 中 的 代码 ， 如 下 所 示 : 


byte directionByte; 
string directionString; 
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orientation myDirection = orientation.north; 
WriteLine ($"myDirection = {myDirection}"); 
directionByte = (byte)myDirection; 

directionString = Convert.ToString (myDirection) ; 
WriteLine($"byte equivalent = {directionByte}"); 
WriteLine($"string equivalent = {directionString}"); 
ReadKey () ; 


(5) 由 次 运行 应 用 程序 ， 输 出 结果 如 图 5-6 所 示 。 


示例 说 明 

这 段 代码 定义 并 使 用 了 一 个 枚 举 类 型 orientation。 首 先 要 注意 ， 类 型 定义 代码 放 在 名 称 空 间 Ch05Ex02 n, 
但 没有 与 其 余 代 码 放 在 一 起 。 这 是 因为 在 运行 期 间 ， 类 型 定义 代码 并 不 像 执行 应 用 程序 中 的 代码 那样 一 行 一 行 
地 执行 。 应 用 程序 是 从 我 们 熟悉 的 位 置 开始 执行 的 ， 它 可 以 访问 新 类 型 ， 因 为 该 类 型 位 于 同一 个 名 称 空间 中 。 

这 个 示例 的 第 一 个 迭代 演示 了 创建 新 类 型 的 变量 ， 给 它 赋 值 以 及 把 它 输出 到 屏幕 上 的 基本 方法 。 接 痢 修 改 代 
码 ， 把 枚 举 值 转换 为 其 他 类 型 。 注 意 这 里 必须 使 用 显 式 转换 。 即 使 orientation 的 基本 类 型 是 byte， 也 仍 必 须 使 
用 (byte) 强 制 实现 类 型 转换 ， 把 myDirection 的 值 转换 为 byte 2378 : 


directionByte = (byte)myDirection; 
如 果 要 将 byte 类 型 转换 为 orientation， 也 同样 需要 进行 显 式 转换 。 例 如 ， 可 以 使 用 下 述 代码 将 byte 变量 
myByte 转换 为 orientation 值 ， 并 将 这 个 值 赋 给 myDirection: 


myDirection = (orientation)myByte; 


当然 ,这 里 必须 要 小 心 , 因为 并 不 是 所 有 byte 类 型 变量 的 值 都 可 以 映射 为 已 定义 的 orientation 值 orientation 
类 型 可 以 存储 其 他 byte 值 ， 所 以 这 么 做 不 会 直接 产生 错误 ， 但 会 在 应 用 程序 的 后 面 违反 逻辑 。 
要 获得 枚 举 值 的 字符 串 值 ， 可 以 使 用 Convert.ToString(): 


directionString = Convert.ToString(myDirection); 


使 用 (string) 强 制 类 型 转换 是 行 不 通 的 , 因为 需要 进行 的 处 理 并 不 仅 是 把 存储 在 枚 举 变量 中 的 数据 放 在 string 
变量 中 ， 而 是 更 复杂 一 些 。 另 外 ， 可 以 使 用 变量 本 身 的 ToString0 命 令 。 下 面 的 代码 与 使 用 Convert.ToSting() 
的 效果 相同 : 


directionstring = myDirection.ToString(); 


也 可 以 把 string 转换 为 枚 举 值 ， 但 其 语法 稍 复 杂 一 些 。 有 一 个 特定 命令 可 用 于 完成 此 类 转换 ， 即 
Enum.Parse0， 其 用 法 如 下 : 


(enumerationType) Enum. Parse (typeof (enumerationType), enumerationValueString); 


这 里 使 用 了 另 一 个 运算 符 typeof， 它 可 以 得 到 操作 数 的 类 型 。 对 orientation 类 型 使 用 这 个 命令 ， 如 下 所 示 : 
string myString = "north"; 


orientation myDirection = (orientation) Enum.Parse (typeof (orientation), 
myString); 


当然 ， 并 非 所 有 字符 串 值 都 会 映射 为 一 个 orientation 值 。 如 果 传 入 的 一 个 值 不 能 映射 为 枚 举 值 中 的 一 个 ， 
就 会 产生 错误 。 与 C# 中 的 其 他 值 一 样 , 这 些 值 是 区 分 大 小 写 的 , 所 以 如 果 字 符 串 与 一 个 值 相同 , 但 大 小 写 不 同 ( 例 
加， 将 myString 设置 为 North 而 不 是 north)， 就 会 产生 错误 。 
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5.2.2 结构 


下 一 个 要 介绍 的 变量 类 型 是 结构 (struct，structure 的 简写 )。 结 构 就 是 由 几 个 数据 组 成 的 数据 结构 ， 这 些 数 
据 可 能 具有 不 同 的 类 型 。 根 据 这 个 结构 ， 可 以 定义 自己 的 变量 类 型 。 例 如 ， 假 定 要 存储 从 起 点 开始 到 某 一 位 置 
的 路 径 ， 路 径 由 方向 和 距离 值 (英里 ) 组 成 。 为 简单 起 见 ， 可 以 假定 该 方 癌 是 指南 针 上 的 一 点 (这 样 ， 方 回 就 可 以 
用 上 一 节 的 orientation 枚 举 来 表示 )， 距 离 值 可 用 double 类 型 来 表示 。 

通过 前 面 的 代码 ， 可 用 两 个 不 同 的 变量 来 表示 路 径 : 


orientation myDirection; 
double myDistance; 


像 这 样 使 用 两 个 变量 ， 是 没有 错误 的 ， 但 在 一 个 地 方 存储 这 些 信息 更 加 简单 (在 需要 多 个 路 径 时 ， 就 万 为 
简单 )。 


定义 结构 

使 用 struct 关键 字 定义 结构 ， 如 下 所 示 : 

struct <typeName> 

<memberDeclarations> 

} 

<memberDeclarations> 部 分 包含 变量 ( 称 为 结构 的 数据 成 员 ) 的 声明 ， 其 格式 与 前 面 的 变量 声明 一 样 。 每 个 成 
员 的 声明 都 采用 如 下 形式 : 


<accessibility> <type> <name>; 


要 让 调用 结构 的 代码 访问 该 结构 的 数据 成 员 ， 可 以 对 <accessibility> 使 用 关键 字 public, Pijin: 
struct route 
i public orientation direction; 
public double distance; 
} 
定义 结构 类 型 后 ， 就 可 以 定义 该 结构 类 型 的 变量 : 


route myRoute; 


还 可 以 通过 句点 字符 访问 这 个 组 合 变量 中 的 数据 成 员 ; 


myRoute.direction = orientation.north; 
myRoute.distance = 2.5; 


下 面 的 “ 试 一 试 ”示例 中 将 演示 这 个 类 型 ， 其 中 使 用 上 一 个 “ 试 一 试 ”示例 中 的 orientation 枚 举 和 上 面 的 
route 结构 。 本 例 在 代码 中 处 理 这 个 结构 ， 以 便 你 了 解 结构 的 工作 原理 。 


试 一 试 ” 使 用 结构 : Ch05Ex03\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter05 目录 中 创建 一 个 新 的 控制 台 应 用 程序 ChOSEx03. 
(2) 将 下 列 代码 添加 到 Program.cs 中 

using statis System.Console; 

using static System.Convert; 


namespace ChO5Ex03 
{ 


enum orientation: byte 
{ 

north = 1, 

south = 2, 

east = 3, 

west = 4 


struct route 

{ 
public orientation direction; 
public double distance; 
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} 
class Program 
{ 
static void Main(string[] args) 
{ 
route myRoute; 
int myDirection = -1; 
double myDistance; 
WriteLine("1) North\n?) South\n3) East\n4) West"); 
do 
{ 
WriteLine ("Select a direction:"); 
myDirection = ToInt32 (ReadLine ()); 
} 
while ((myDirection < 1) || (myDirection > 4)); 
WriteLine ("Input a distance:"); 
myDistance = ToDouble (ReadLine ()); 
myRoute.direction = (orientation) myDirection; 
myRoute.distance = myDistance; 
WriteLine($"myRoute specifies a direction of {myRoute.direction} ”十 
s"and a distance of (myRoute.distance]"); 
ReadKey () ; 
} 
} 
} 


(3) 执行 代码 ， 输 入 一 个 属于 1-4 范围 内 的 数字 ， 以 选择 一 个 方向 ， 输 入 一 个 距离 值 ， 结 果 如 图 5-7 所 示 。 


示例 说 明 
结构 和 枚 举 一 样 ， 也 是 在 代码 的 主体 之 外 声明 。 在 名 称 空 间 声 明 中 声明 route 结构 及 其 使 用 的 orientation 
BUS: 


enum orientation: byte 


i 
north - 1, 
south = 2, 
east = 3, 
west =4 


struct route 


i 
public orientation direction; 
public double distance; 


} 
代码 的 主体 结构 与 前 面 的 一 些 示例 代码 类 似 ， 要 求 用 户 输入 一 些 信息 ， 并 显示 它们 。 把 方向 选择 放 在 do 
循环 中 ,对 用 户 的 输入 进行 有 效 性 检查 , 拒绝 不 属于 1-4 范围 的 整数 输入 (选择 该 范围 中 的 值 可 以 映射 到 枚 举 成 
员 ， 从 而 方便 赋值 )。 


注意 : 
不 能 解释 为 整数 的 输入 会 导致 一 个 错误 。 本 章 后 面 会 说 明 其 原因 和 处 理 方 法 。 
注意 ， 在 引用 route 的 成 员 时 ， 处 理 它 们 的 方式 与 处 理 成 员 类 型 相同 的 变量 完全 一 样 。 赋 值 语 句 如 下 所 示 : 


myRoute.direction = (orientation)myDirection; 
myRoute.distance = myDistance; 


可 下 接 把 输入 的 值 放 到 myRoute.distance 中 ， 而 不 会 有 负面 效果 ， 如 下 所 示 : 


myRoute.distance = ToDouble (ReadLine()); 
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还 应 进行 有 效 性 验证 ， 但 这 段 代 码 不 存在 这 一 步骤 。 对 结构 成 员 的 任何 访问 都 以 相同 的 方式 处 理 。 
<structVar> .<memberVar> 形 式 的 表达 式 可 计算 <memberVar> 类 型 的 变量 的 值 。 


5.2.3 数组 


前 面 的 所 有 关 型 有 一 个 共同 点 : 它们 都 只 存储 一 个 值 (结构 中 存储 一 组 值 )。 有 时 ， 需 要 存储 许多 数据 ， 这 
样 就 会 市 来 不 便 。 有 时 需要 同时 存储 几 个 相同 类 型 的 什 ， 而 不 想 为 每 个 值 使 用 不 同 的 变量 。 

例如 ， 假 定 要 对 所 有 朋友 的 姓名 执行 一 些 操 作 。 可 以 使 用 简单 的 字符 串 变 量 ， 如 下 所 示 : 

string friendNamel = "Todd Anthony"; 

string friendName2 = "Kevin Holton"; 

string friendName3 = "Shane Laigle"; 

(A A ROK Ts BUR LIE, ERI m BES AP IY RA REA AREE. BON, ANE EDA ATI 
"ERE MR 

另 一 种 方式 是 使 用 数组 。 数 组 是 一 个 变量 的 索引 列表 ， 存 储 在 数组 类 型 的 变量 中 。 例 如 ， 有 一 个 数组 
friendNames 存储 上 述 3 个 名 字 。 在 方 插 号 中 指定 索引 ， 即 可 访问 该 数组 中 的 各 个 成 员 ， 如 下 所 示 : 

friendNames [<index>] 

这 个 索引 是 一 个 整数 ， 第 一 个 条 目的 索引 是 0， BOPRANRS 1, MERE. ROR REE) DAE A a 
历 所 有 条 目 ， 例 如 : 

int is 

for (i = 0; i < 3; i++) 

WriteLine ($"Name with index of {i}: {friendNames[i]}"); 

数组 有 一 个 基本 类 型 ， 数 组 中 的 各 个 条 目 都 是 这 种 类 型 。friendNames 数组 的 基本 类 型 是 字符 串 ， 因 为 它 要 
存储 string 变量 。 数 组 的 条 目 通 常 称 为 元 素 。 
1. 再 明 数组 
采用 下 述 方式 声明 数组 : 
<baseType>[] <name>; 
其 中 ，<baseType> 可 以 是 任何 变量 类 型 ， 包 括 本 章 前 面 介绍 的 枚 举 和 结构 类 型 。 数 组 必须 在 访问 之 前 初始 
不 能 像 下 和 面 这 样 访问 数组 或 给 数组 元 素 赋 值 : 


int[] myIintArray; 
myIntArray[10] = 5; 


数组 的 初始 化 有 两 种 方式 。 可 以 字面 值 形 式 指定 数组 的 完整 内 容 ， 也 可 以 指定 数组 的 大 小 ， 再 使 用 关键 字 
new HURA RHAI R. 

BE AF Hee A, Wie ett THe Soa cA, AIRE P, Bild: 

int[] myIntArray = { 5, 9, 10, 2, 99 }; 

其 中 ，myIntArray 有 5 个 元 素 ， 每 个 元 素 部 被 赋予 一 个 整数 值 。 

男 一 种 方式 需要 使 用 下 述 语法 : 

int[] myIntArray = new int[5]; 

这 里 使 用 关键 字 new 显 式 地 初始 化 数组 ， 用 一 个 常量 值 定 义 其 大 小 。 这 种 方式 会 给 所 有 数组 元 素 赋予 同一 
个 默认 值 ， 对 于 数值 类 型 来 说 ， 其 默认 值 是 0。 也 可 以 使 用 非常 量 的 变量 来 进行 初始 化 ， 例 如 : 

int[] myIntArray = new int[arraySize]; 


还 可 以 根据 需要 组 合 使 用 这 两 种 初始 化 方式 : 


化 


E 
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int[] myIntarray = new int[5] { 5, 9, 10, 2, 99 }; 
AKA, BAK) Oa Src TROVE BO. Pilon, A Bed Ss on PARES: 
int[] myIntArray = new int[10] { 5, 9, 10, 2, 99 }; 
其 中 数组 定义 为 有 10 AR, 但 只 定义 了 5 个 元 素 ， 所 以 编译 会 失败 。 如 果 使 用 变量 定义 其 大 小 ， 该 变量 


必须 是 一 个 当量 ， 例 如 : 


const int arraySize = 5; 
int[] myIntArray = new int[arraySize] { 5, 9, 10, 2, 99 }; 


如 果 省 略 了 关键 字 const， 运 行 这 段 代码 就 会 失败 。 
与 其 他 变量 类 型 一 样 ， 并 非 必须 在 声明 数组 的 代码 行 中 初始 化 该 数组 。 下 面 的 代码 是 合法 的 : 


int[] myIntArray; 
myIntArray = new int[5]; 


下 面 的 示例 利用 了 本 节 开头 的 示例 ， 创 建 并 使 用 一 个 字符 串 数 组 。 


试 一 试 ” 使 用 数组 : Ch05Ex04\Program.cs 


(1) f£ C:\BeginningCSharp7\Chapter05 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch05Ex04。 
(2) 将 下 列 代码 添加 到 Program.cs 中 : 


static void Main(string[] args) 
{ 
string[] friendNames = { "Todd Anthony", "Kevin Holton", 
"Shane Laigle" }; 
int i; 
WriteLine($"Here are {friendNames.Length} of my friends:"); 
for (1 = 0; i < friendNames.Length; i++) 
{ 
WriteLine (friendNames[i]); 
} 
ReadkKey () ; 
} 


(3) 执行 代码 ， 结 果 如 图 5-8 所 示 。 


5-8 


示例 说 明 

这 段 代码 用 3 个 值 建 立 了 一 个 string 数组 ， 并 在 for 循环 中 把 它们 列 在 控制 台 上 。 使 用 friendNames.Length 
来 确定 数组 中 的 元 素 个 数 : 

WriteLine($"Here are {friendNames.Length} of my friends:"); 

这 是 获取 数组 大 小 的 一 种 简便 方法 。 在 for 循环 中 输出 值 容易 出 错 。 例 如 ， 把 < 改 为 二 ， 如 下 所 示 : 


for (1 = 0; 1 <= friendNames.Length; i++) 


{ 


WriteLine(friendNames[il): 


| 
编译 并 执行 上 述 代 码 ， 就 会 弹出 如 图 5-9 所 示 的 对 话 框 。 
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Exception Unhandled =x 


System.IndexOutOfRangeException: index was outside the bounds of 
the array. 


b Exception 5 $exception M 
| Add Watch 
Value: 


4 @ Sexception ("Index was outside the bounds of the array.) | System.lr 
b # Data {System.Collections.ListDictionaryinternal) | System.C 


* HResult -2 146233080 | int 
# HelpLink null (string 
b> # InnerException null |System.E 
# Message “Index was outside the bounds of the array.” A =| string 
* Source "Ch05Ex04" Q | string 
J9 StackTrace ” atChO5Ex04.Program. Main(String[] args) in Cy BeginningCSharp X & +) string 
bo TargetSite {Void Main(System.String[])) | System.R 
b “g Static members 
P @ Non-Public members 


图 5-9 


这 里 ， 代 码 试图 访问 friendNames[3]. 1E, ZHR MMRR. Pros — T 7638 7€ 位 endNames[2]。 如 果 
v ET; np HANE Ux. TSR lee. xeupbpDBi—- eu BRPEPIZTHEOKUIWIAIBHUJBPA BU. B 
使 用 foreach 循环 。 


2. foreach 循环 
foreach A} u] GA AA — Ap fe (BY PERE 12 BAZ BET JU : 


foreach (<baseType> <name> in <array>) 

// can use <name> for each element 

} 

这 个 循环 会 迭代 每 个 元 素 ， 依 次 把 每 个 元 素 放 在 变量 -waxmxe> 中 ， 且 不 存在 访问 非法 元 素 的 危险 。 不 需要 考 
虚数 组 中 有 和 多少 个 元 素 ， 并 可 以 确保 将 在 循环 中 使 用 每 个 元 素 。 使 用 这 个 循环 ， 可 以 修改 上 个 示例 中 的 代码 ， 
如 下 所 示 : 


static void Main(string[] args) 


string[] friendNames = { "Todd Anthony", "Kevin Holton", 
"Shane Laigle" }; 

WriteLine($"Here are {friendNames.Length} of my friends:"); 

foreach (string friendName in friendNames) 

{ 

WriteLine (friendName) ; 
} 
ReadKey () ; 
} 


这 段 代 码 的 输出 结果 与 前 面 的 “ 试 一 试 ”示例 完全 相同 。 使 用 这 种 方法 和 标准 的 for 循环 的 主要 区 别 在 于 : 
foreach 循环 对 数组 内 容 进 行 只 读 访 问 ， 所 以 不 能 改变 任何 元 率 的 值 。 例 如 ， 不 能 编写 如 下 代码 : 

foreach (string friendName in friendNames) 

friendName = "Rupert the bear"; 

} 

GRAPE ES, BEAU. [EUR S FH fa] LT] for 循环 ， 就 可 以 给 数组 元 素 赋 值 。 

3. 使 用 switch case 表达 式 进行 模式 匹配 


第 4 草 介 绍 了 switch 语句 。 在 该 草 的 讨论 中 , switch case 基于 特定 变量 的 值 .回忆 一 下 下 面 的 代码 , <testVar> 
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的 类 型 已 知 ， 例 如 ， 可 以 是 integer. string 或 者 boolean。 如 果 是 integer 类 型 ， 则 变量 中 存储 的 是 数字 值 ，case 
语句 将 检查 特定 的 整数 值 1、2、3 等 )， 当 找到 相 匹配 的 数字 后 ， 就 执行 对 应 的 代码 。 
switch (<testVar>) 
{ 
case <comparisonVall>: 
<code to execute if <testVar> == <comparisonVall> > 
break; 
case <comparisonVal2>: 
<code to execute if <testVar> == <comparisonVal2> > 
break; 


case «comparisonValN»: 
«code to execute if <testVar> == <comparisonValN> > 
break; 

default: 
«code to execute if <testVar> !- comparisonVals> 
break; 


| 
C& 7 中 可 以 基于 变量 的 类 型 (如 string 或 integer 数组 ) 在 switch case 中 进行 模式 匹配 。 因 为 变量 的 类 型 是 已 
知 的 ， 所 以 可 以 访问 该 类 型 提供 的 方法 和 属性 。 得 看 下 面 的 switch 结构 : 


switch (<testVar>) 
{ 
case int value: 
<code to execute if <testVar> is an int > 
break; 
case string s when s.Length == 
«code to execute if <testVar> is a string with a length = 0 > 
break; 


case null: 
<code to execute if <testVar> == null > 
break; 
default: 
<code to execute if <testVar> != comparisonVals> 
break; 


} 

case 关键 字 之 后 紧 跟 的 是 想 要 检查 的 变量 类 型 (string、int 等 )。 在 case 语句 匹配 时 ， 该 类 型 的 值 将 保存 到 声 
明 的 变量 中 。 例 如 ， 右 <testVar> 是 一 个 integer 类 型 的 值 ， 则 该 integer 的 值 将 存储 在 变量 value 中 。 接 下 来 ， 
注意 C#7 将 when 关键 字 修 饰 从 应 用 到 了 switch case 表达 式 (when 关键 字 修 饰 符 在 C#6 中 引入 , 称 为 表达 式 
过 滤器 ， 第 7 理会 进一步 讨论 )。when 关键 字 修 饰 符 允许 扩展 或 添加 一 些 额外 的 条 件 ， 以 执行 case 语句 中 的 

下 面 的 示例 对 上 述 内 容 进 行 了 详解 ， 并 说 明了 其 他 几 个 概念 。 


试 一 试 ” 使 用 数组 : Ch05Ex05\Program.cs 


(1) 在 C\BeginningCSharp7\Chapter0S 目录 中 创建 一 个 新 的 控制 台 应 用 程序 ChOSEXOS. 
(2) 将 下 列 代码 添加 到 Program.cs 中 


static void Main(string[] args) 
{ 
string[] friendNames = { "Todd Anthony", "Kevin Holton", 
"Shane Laigle", null, "" Jj; 
foreach (var friendName in friendNames) 


switch (friendName) 
{ 
case string t when t.StartsWith("T"): 
WriteLine("This friends name starts with a 'T': " + 
S"[friendName]) and is [t.Length - 1} letters long "); 
break; 
case string e when e.Length == 
WriteLine("There is a string in the array with no value"); 
break; 
case null: 
WriteLine("There was a 'null' value in the array"); 
break; 
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case var x: 

WriteLine("This is the var pattern of type: " + 
o"{x.GetType().Name}"); 

break; 

default: 
break; 

} 

} 


int sum = 0, total = 0, counter = 0, intValue = 0; 
int?[] myIntArray = new int?[7] { 5, intValue, 9, 10, null, 2, 99 }; 
foreach (var integer in myIntArray) 


switch (integer) 
{ 
Case 0: 
WriteLine($"Integer number '{ total }' has a default value of 0"); 
counter++; 
break; 
case int value: 
sum += value; 
WriteLine($"Integer number "{ total )' has a value of {value}"); 
counter-4-; 
break; 
Case null: 
WriteLine($"Integer number '"{ total }' is null"); 
counter++; 
break; 
default: 
break; 
} 
} 
WriteLine($"{total} total integers, {counter} integers with a" + 
S"value other than 0 or null have a sum value of [sum]"); 
ReadLine(); 
} 


(3) 确保 添加 using static System.Console; 语 句 后 ， 执 行 代码 。 结 果 如 图 5-10 所 示 。 


图 5-10 


示例 说 明 
本 示例 中 有 两 个 foreach 循环 : — 3E sting[] 数组 ， 另 一 个 运 代 nt BZN. JER string[] 数 组 的 foreach 
循环 包含 一 个 null 值 和 一 个 不 包含 值 的 项 ， 用 于 详细 描述 模式 匹配 (Pattern Matching) 概 念 。 


string[] friendNames = { "Todd Anthony", "Kevin Holton", 
"Shane Laigle", null, "" }; 


switch 表达 式 中 包含 4 个 case 语句 : 

case string t when t.StartsWith ("T") 

当 把 非 模式 匹配 的 switch 语句 与 本 示例 进行 比较 时 ， 可 以 看 出 最 显著 的 区 别 在 于 ， 这 里 匹配 的 并 不 是 一 个 
特定 的 值 ， 如 1、2 Bk “Beginning C£ Rocks”， 而 在 case 语句 后 直接 是 一 个 字符 串 t 的 类 型 声明 。 进 行 类 型 声明 
Ja» t 束 可 以 用 来 访问 friendName 中 的 值 以 及 string 类 型 中 可 用 的 方法 和 属性 。 注 意 ， 在 when RIARI AY) 
使 用 了 System.String 类 的 StartsWith0 方 法 。 该 方法 接受 一 个 参数 , 并 且 如 果 friendName 中 的 字符 串 值 以 这 个 参 
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数 开头 (本 例 中 为 "T")， 则 与 case 语句 相 匹配 ， 将 执行 该 case 语句 。 

ill] switch case 表达 式 检 查 一 个 字符 溃 是 否 为 空 : 

case string e when e.Length == 0 

同样 ，string 声明 e 引用 System.String 类 的 Length 属性 。 如 果 长 度 为 0， 束 执行 该 case 语句 。 下 面 的 代码 
片段 是 一 个 case 表达 式 ， 检 查 friendName 中 的 值 是 否 为 null: 

case null 

下 面 的 代码 片段 演示 了 如 何 使 用 x 的 var 声明 捕获 任何 其 他 变量 类 型 。 我 们 知道 该 数组 中 的 所 有 元 素 都 是 
字符 串 ， 但 在 某 些 实现 中 ， 数 组 可 能 是 一 个 由 未 知 对 象 组 成 的 数组 。 此 时 ， 通 过 X 使 用 System.Object 类 的 GetType() 
方法 ， 可 以 看 到 其 类 型 : 

该 表达 式 引出 了 模式 匹配 特性 的 一 个 关键 点 : case 表达 式 的 顺序 现在 很 重要 。 若 将 case var x 表达 式 放 在 switch 
语句 的 项 部 , 将 捕获 所 有 的 string 或 string[] 中 的 一 切 内 容 。 但 不 必 担 心 , 编译 右 会 友 出 警告 , 通知 你 “the switch 
case has already been handled by a previous case(i% switch case 已 由 上 一 个 case 语句 处 理 )”。 现 在 ， 在 具备 模式 匹 
配 能 力 后 ， 应 做 到 让 表达 式 过 滤器 尽 可 能 精确 ， 且 在 switch 语句 中 应 该 是 唯一 的 。 

对 于 int[] 数组 ， 也 有 几 点 需要 深入 理解 : 

int?[] myIntArray = new int?[7] { 5, intValue, 9, 10, null, 2, 99 }; 

自 先 要 注意 的 是 紧 跟 在 int PA Ze S (2). AS S Eik ee AIS T int[]AXH n] AO RR, Ar 
有 这 个 问号 ， 就 会 显示 编译 异常 。 其 次 要 注意 在 初始 化 一 个 整数 时 ， 通 常 将 其 值 默认 设置 为 0。 如 果 编 写 一 个 
switch case 表达 式 来 检查 整数 ， 则 应 该 检查 默认 值 为 0 的 情况 ， 并 进行 适当 处 理 。 

case 0 

如 果 没 有 检查 0， 就 会 进入 下 一 个 case 语句 : 


case int value: 
sum += value; 


给 sum 加 0 后 并 不 会 导致 值 的 改变 ， 而 这 正 是 代码 在 没有 case 0 表达 式 时 的 行为 。 审 查 一 下 代码 ， 会 发 现 
只 有 在 整数 值 不 为 0 和 null 时 ， 才 可 以 与 sum 和 counter 相 加 。 所 有 迭代 都 会 导致 total 增加 1。 如 果 不 编写 代 
码 ， 丈 不 知道 0 是 实际 值 ， 还 是 添加 到 数组 的 一 个 默认 初始 值 。case 0 为 我 们 提供 了 执行 代码 并 验证 这 一 点 的 
机 会 。 

下 面 的 代码 上 户 段 汗 示 了 case 表达 式 如 何 检查 value 中 的 值 是 否 为 null; 

case null 

除了 switch case 表达 式 模式 外 ， 还 可 以 使 用 is 关键 字 实现 模式 匹配 。 本 章 并 不 会 介绍 is 关键 字 ， 到 第 11 
章 将 学 习 如 何 使 用 它 实 现 模式 匹配 。 

4. 多 维 数组 

多 维 数组 是 使 用 多 个 索引 访问 其 元 条 的 数组 。 例 如 ， 假 定 要 确定 一 座 山 相对 于 茶 位 置 的 高 度 ， 可 使 用 两 个 
坐标 x 和 y 来 指定 一 个 位 置 。 把 这 两 个 坐标 用 作 索 引 ， 让 数组 hillHeight 可 以 用 每 对 坐标 来 存储 高 度 ， 这 就 要 
使 用 多 维 数组 了 。 

像 这 样 的 二 维 数组 可 以 声明 如 下 : 

<baseType>[,] <name>; 

多 维 数组 只 需要 更 多 逗号 ， 例 如 : 

«baseType»[,,,] <name>; 

该 语句 声明 了 一 个 A 维 数组 。 赋 值 也 使 用 类 似 的 语法 ， 用 逗号 分 隔 大 小 。 要 声明 和 初始 化 二 维 数组 hillHeight， 
其 基本 类 型 是 double，x 的 大 小 是 3，y 的 大 小 是 4， 则 需要 : 
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double[,] hillHeight = new double[3,4]; 

i uf EA Hoe EET We. ARE SR, EV ZA Sa, Pin: 

double|,) hillHeight = [ I 1, 2, 3d, 4 Jj, { 2, 3, 4, 5], I 3, 4, S bl) bk 

这 个 数组 的 维度 与 前 面 的 相同 ， 也 是 3 行 4 列 。 通 过 提供 字面 值 隐 式 定 义 了 这 些 维度 。 

要 访问 多 维 数 组 中 的 每 个 元 素 ， 只 需要 指定 它们 的 案 引 ， 并 用 逗号 分 开 ， 例 如 : 

hillHeight [2,1] 

TE AY VARA Ec AGE D. EK PS AIA) IRI E Tí E MN 3 “MRE APS 2 76038 
(其 值 是 和。 记 住 ， 索 引 从 Oss, A-T AS EREINBA. REZ, BMS ES, 2 个 数字 
指定 该 对 花 括 号 中 的 元 素 。 用 图 5-11 来 可 视 化 地 表示 这 个 数组 。 


hillHeight [0,0] hillHeight [0,1] hillHeight [0,2] hillHeight [0,3] 
| 3 SLL 2è IL è ji ^*^ -— 
hillHeight [1,0] hillHeight [1,1] hillHeight [1,2] hillHeight [1,3] 
| 2 [Ji 3 || * j| sS | 


hillHeight [2,0] hillHeight [2,1] hillHeight [2,2] hillHeight [2,3] 
| 3 JSL * | $ | 


E] 5-11 


foreach 循环 可 以 访问 多 维 数组 中 的 所 有 元 素 ， 其 方式 与 访问 一 维 数组 相同 ， 例 如 : 


double[,] hillHeight = { { 1, 2, 3, 4], { 2, 3, 4, 5 }, { 3, 4, 5, 6 } 1}; 
foreach (double height in hillHeight) 


WriteLine($"[height]"); 
} 


JU Rs MITA E DLE aR F E FSP A I] QR E AN Y IRER WA FF TU HE SE p): 


hillHeight [0,0] 
hillHeight [ 
hillHeight [ 
hillHeight [ 
hillHeight [ 
hillHeight [ 
hillHeight [ 
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5. 数组 的 数组 

上 一 市 讨论 的 多 维 数组 可 称 为 矩形 数组 ， 这 是 因为 每 一 行 的 元 系 个 数 部 相同 。 使 用 上 一 个 示例 ， 任 何 一 个 
x 坐标 都 有 一 个 对 应 0 至 3 的 y 4b. 

tu] UEH RAAH Gagged array)， 其 中 每 行 的 元 系 个 数 可 能 不 同 。 为 此 ， 需 要 有 这 样 一 个 数组 ， 其 中 的 
每 个 元 素 都 是 男 一 个 数组 。 也 可 以 有 数组 的 数组 的 数组 ， 甚 至 更 复杂 的 数组 。 但是， 注意 这 些 数 组 都 必须 有 相 
同 的 基本 类 型 。 

声明 数组 的 数组 时 ， 其 语法 要 求 在 数组 的 声明 中 指定 多 个 方 括号 对 ， 例 如 ; 

int[][] jaggedIntArray; 

但 初始 化 这 样 的 数组 不 像 初始 化 多 维 数组 那样 简单 ， 例 如 ， 不 能 采用 以 下 声明 方式 ; 

jaggedIntArray = new int[3] [4]; 

即使 可 以 这 样 做 ， 也 不 是 很 有 效 ， 因 为 使 用 简单 的 多 维 数 组 可 以 较为 轻松 地 取得 相同 的 结果 。 也 不 能 使 用 
下 面 的 代码 : 
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jaggedintarray = ( (1, 2, 3}, {11}, (1, 2 } kr 
有 两 种 方式 : 可 以 初始 化 包含 其 他 数组 的 数组 (为 清晰 起 见 ， 称 其 为 子 数组 )， 然 后 依次 初始 化 子 数组 。 


jaggedIntArray = new int[2][]; 
jaggedIntArray[0] = new int[3]; 
jaggedIntArray[1] = new int[4]; 


也 可 以 使 用 上 述 字 面值 赋值 的 一 种 改进 形式 : 


jaggedIntArray = new int[3][] { new int[] { 1, 2, 3 }, new int[] { 1 }, 
new int[] { 1, 2 } Hk 


也 可 以 进行 简化 ， 把 数组 的 初始 化 和 声明 放 在 同一 行 上 ， 如 下 所 示 : 


int[][] jaggedIntArray = { new int[] { 1, 2, 3 }, new int[] { 1 }, 
new int[] { 1, 2 } hk 


可 对 锯齿 数组 使 用 foreach A, {Aa ii BE HH CETT] foreach 循环 才能 得 到 实际 数据 。 例 如 ， 假 定 下 述 
锯齿 数组 包含 10 个 数组 ， 每 个 数组 义 包 含 一 个 整数 数组 ， 其 元 素 是 1-10 的 约 数 : 


int[1[] divisorslTo10 = [new int[] { 1 }, 
new int[] { 1, 2 }, 
new int[] { 1, 3 }, 
new int[] { 1, 2, 4 }, 
new int[] { 1, 5 ], 
new int[] | 1, 2, 3, 6 ], 
new int[] { 1, 7 }, 
new int[] { 1, 2, 4, 8 }, 
new int[] { 1, 3, 9 }, 
new int[] { 1, 2, 5, 10 } } 
以 下 代码 会 失败 ; 
foreach (int divisor in divisorslTo10) 
{ 


WriteLine (divisor); 


这 是 因为 数组 divisorsl To10 包含 的 是 int[ ORM AE int TUR. IE BAIT HIE AE Ui MORD SEAT FB 
A: 
foreach (int[] divisorsofInt in divisors1To10) 
| foreach(int divisor in divisorsofInt) 
WriteLine (divisor); 
l } 


可 以 看 出 ， 使 用 锯齿 数组 的 语法 要 复杂 得 多 ! 大 多 数 情 况 下 ， 使 用 矩形 数组 比较 简单 ， 这 是 一 种 比较 简单 
的 存储 方式 。 但 是 ， 有 时 必须 使 用 锯齿 数组 ， 所 以 知道 如 何 使 用 它们 是 没有 坏处 的 。 一 个 例子 是 ， 使 用 XML 
文档 时 ， 其 中 一 些 元 素 有 子 元 隶 ， 而 一 些 元 了 背 没有 。 


5.3 ”字符 串 的 处 理 


到 目前 为 止 ， 对 字符 串 的 使 用 还 仅 限于 把 字符 串 写 到 控制 侣 ， 从 控制 台 读 取 字 得 串 ， 以 及 使 用 + 运算 从 连 
接 字 符 串 。 在 编写 较 有 趣 的 应 用 程序 时 ,会 友 现 字符 串 的 操作 非 剃 多。 所 以 ,下 面 占用 几 页 的 篇 幅 介 绍 C# 中 较 
第 用 的 字符 串 处 理 技巧 。 

首先 要 注意 ，string 类 型 的 变量 可 以 看 成 是 char 变量 的 只 读数 组 。 这 样 ， 融 可 以 使 用 下 面 的 语法 访问 每 个 
FIT: 


string myString = "A string"; 
char myChar = myString[1]; 


但 不 能 采用 这 种 方式 为 名 个 字符 赋值 。 为 获得 一 个 可 写 的 char 数组 ， 可 以 使 用 下 面 的 代码 ， 其 中 使 用 了 数 
组 变量 的 ToCharArray0O 命 令 : 


string myString = "A string"; 
char[] myChars = myString.ToCharArray(); 
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Bea aon] DAA a AAEE char 数组 了 了。 也 可 在 foreach 循环 中 使 用 字符 串 ， 例 如 : 
foreach (char character in myString) 


WriteLine ($"{character}"); 


与 数组 一 样 ， 还 可 以 使 用 myString Length ACHR TAL RRS PINS Pi: 


string myString = ReadLine(); 
WriteLine($"You typed {myString.Length} characters."); 


其 他 基本 和 字符 串 处 理 技巧 采用 与 这 个 <string>.ToCharArray0 命 令 类 似 的 格式 使 用 命令 。 两 个 简单 却 有 效 的 
命令 是 <strine>.ToLowerO 和 和 <string>.ToUpperO0。 它 们 可 以 分 别 把 学 符 串 转换 为 小 写 和 大 写 形式 。 为 理解 它们 的 
重要 作用 ， 可 以 考虑 下 面 的 情形 : 要 检查 用 户 的 某 个 啊 应 ， 例 如 字符 串 yes。 如 果 可 以 把 用 户 输入 的 字符 串 转 
换 为 小 写 形式 ， 束 也 能 检 答 字符 串 YES. Yes. yeS 等 ， 第 4 划 介 绍 了 这 样 一 个 示例 : 


string userResponse = ReadLine(); 
if (userResponse.ToLower() == "yes") 


// Act on response. 


} 

注意 ， 这 个 命令 与 本 节 的 其 他 命令 一 样 ， 并 未 真正 改变 应 用 它 的 字符 串 。 把 这 个 命令 与 字符 串 结合 使 用 ， 
就 会 创建 一 个 新 的 字符 串 ， 以 便 与 男 一 个 字符 串 进行 比较 (如 上 所 述 )， 或 者 赋 给 男 一 个 变量 。 该 变量 可 以 是 当 
前 操作 的 其 他 变量 ， 例 如 : 

userResponse = userResponse.ToLower(); 

记 住 这 一 点 很 重要 ， 因 为 只 写 出 下 面 的 代码 是 没有 效果 的 : 

userResponse.ToLower (); 


下 面 看 看 在 简化 用 户 输入 方面 还 可 以 做 什么 。 如 果 用 户 无 意 间 在 输入 内 容 的 前 面 或 后 面 添加 了 多 余 的 空格 ， 
REFE? 此 时 , 上 述 代码 区 不 起 作用 了 。 这 束 需 要 删除 所 输入 的 字符 串 前 后 的 空格 , 此 时 可 以 使 用 <sitring>.TrimO 
命令 来 处 理 : 

string userResponse = ReadLine (); 

userResponse = userResponse.Trim(); 


if (userResponse.ToLower() == "yes") 


// Act on response. 


} 

使 用 该 命令 ， 还 可 以 检测 如 下 字符 串 : 

= TER" 

"Yes " 

也 可 以 使 用 这 些 命令 删除 其 他 字符 ， 只 要 在 一 个 char 数组 中 指定 这 些 字符 即 可 ， 例 如 : 
char[] trimChars = [' ', 'e', 's'H 


string userResponse = ReadLine(); 
userResponse = userResponse.ToLower (); 
userResponse = userResponse.Trim(trimChars); 
if (userResponse == "y") 

{ 


// Act on response. 
这 将 删除 字符 串 前 后 的 所 有 空格 、 字 母 e 和 s。 如 果 字 符 串 中 没有 其 他 字符 ， 就 会 检测 以 下 字符 串 : 


"Yeeeees" 
wT y" 


还 可 以 使 用 <string>.TrimStart0 和 <string>.TrimEnd0 命 令 ， 它 们 可 以 删除 字符 串 前 面 或 后 面 的 空格 。 使 用 这 
些 命令 时 也 可 以 指定 char 数组 。 
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还 有 郊外 两 个 字符 串 命令 也 可 以 处 理 字符 串 的 空格 : <string>.PadLeft0 和 <string>.PadRight0。 EIH EFIT B 
的 左边 或 右边 添加 空格 ， 使 字符 串 达 到 指定 的 长 度 。 其 语法 如 下 : 


<string>. PadxX (<desiredLength>) ; 


例如 : 


myString = "Aligned"; 
myString = myString.PadLeft (10); 


这 将 在 myString 中 把 3 个 空格 添加 到 单词 Aligned 的 左边 。 这 些 方法 可 用 于 在 列 中 对 齐 字符 串 ， 特 别 适 于 
放置 包含 数字 的 字符 串 。 

与 修整 命令 一 样 ， 还 可 以 按 第 二 种 方式 使 用 这 些 命 令 ， 即 提供 要 湛 加 到 字符 串 上 的 字符 。 但 是 这 需要 一 个 
char 字符 ， 而 不 是 像 修 整 命令 那样 指定 一 个 char 数组 。 例 如 : 


myString = "Aligned"; 
myString = myString.PadLeft(10, '-'); 


这 将 在 myString 的 开头 加 上 3 个 短 横 线 。 

还 有 许多 这 样 的 字符 串 处 理 命令 ， 其 中 一 些 只 用 于 非常 特殊 的 情况 ， 在 后 和 面 的 章节 中 过 到 它们 时 再 进行 讨 
论 。 在 继续 下 面 的 内 容 之 前 ， 有 必要 介绍 Visual Studio 2017 中 的 一 个 特性 ， 前 几 章 (特别 是 本 章 ) 兽 提 及 过 这 个 
特性 。 下 面 的 示例 会 试验 语句 自动 完成 (auto-completiom 功 能 ，IDE 通过 这 种 功能 试 着 给 出 用 户 有 可 能 要 插入 的 
代码 。 


试 一 试 Visual Studio 中 的 语句 自动 完成 功能 : Ch05Ex06\Program.cs 


(1) f£ C:\BeginningCSharp7\Chapter05 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch05Ex06。 
(2) 在 Program.cs 中 输入 下 列 代码 ， 注 意 输入 过 程 中 弹出 的 窗口 : 


static void Main(string[] args) 
{ 
string myString = dur is a Lest. 
char[] separator = {' 
string[] myWords; 
myWords = myString. 
} 


(3) 输入 最 后 的 句点 时 ， 注 意 会 阐 出 如 图 5-12 所 示 的 窗口 。 


Wi, AsEnumerable<> 
Sí AsParallel 

Ty AsParallel<-> 

&$ AsQueryable 

©; AsQueryable< > 


图 5-12 


(4) — r 弹出 窗口 就 会 改变 ， 显 示 一 个 工具 提示 ， 如 图 5-13 所 示 。 


(5) 输入 字符 “(se”， 会 弹出 另 一 个 窗口 和 工具 提示 ， 如 网 5-14 所 示 。 
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ll} 


9 lAppDomainSetup 
© |ServiceProvider 
O |Set<> 
** NonSerializedAttribute 


(local variable) nat separator 


全 SerializableAttribute 
Pe SortedSet « > 
Dis] ra .0 +s a 


5-14 


(6) 输入 两 个 字符 “); ”， 代 码 如 下 所 示 ， 弹 出 窗口 随 之 消失 : 


static void Main(string[] args) 
{ 
string myString = "This is a test."; 
char[] separator = {' "}; 
string[] myWords; 
myWords = myString.Split (separator); 
} 


C) SU PIAS. ERA AN af (AES 1 480 using static System.Console;): 


static void Main(string[] args) 
i 
string myString = "This is a test."; 
char[] separator = {' "}; 
string[] myWords; 
myWords = myString.Split (separator); 
foreach (string word in myWords) 
{ 
WriteLine ($"{word}"™); 
} 
ReadKey () ; 
} 


(8) 执行 代码 ， 结 果 如 图 5-15 所 示 。 


= 5-15 


示例 说 明 
在 这 段 代 码 中 ， 要 注意 两 点 。 第 一 氮 是 所 使 用 的 新 字符 串 命 令 ， 第 二 点 是 使 用 了 目 动 完成 功能 。 使 用 命令 
<string> Split string 字符 串 转换 为 string 数组 ， 把 它 在 指定 的 位 置 隔 开 。 这 些 位 置 采 用 了 char 数组 形式 ， 在 
本 例 中 该 数组 只 有 一 个 元 素 ， 即 空格 字符 : 
char[] separator = {" "}; 


下 面 的 代码 把 字符 串 在 每 个 空格 处 分 解 开 ， 并 获取 得 到 的 子 字 符 串 ， 即 得 到 包含 单个 单词 的 数组 : 


string[] myWords; 
myWords = myString.Split (separator); 


Het fi Hl foreach 循环 和 迭代 这 个 数组 中 的 单词 ， 并 把 这 些 单词 写 到 控制 全 : 


foreach (string word in myWords) 
{ 
WriteLine ($"{word}"); 


} 
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注意 : 


得 到 的 每 个 单词 都 没有 空格 ， 单 词 的 内 部 和 两 端 都 没有 空格 。 在 使 用 split0 时 ， 删 除了 分 隔 符 。 


54 习题 


(1) 下 面 的 转换 哪些 不 是 隐 式 转换 ? 

a. int 转换 为 short 

b. short 转换 为 int 

c. bool 转换 为 string 

d. byte 转换 为 float 

(2) 以 short 类 型 作为 基本 类 型 编写 一 个 color 枚 举 ， 使 其 包含 彩虹 的 颜色 加 上 黑色 和 日 色 。 这 个 枚 举 可 使 
用 byte 类 型 作为 基本 类 型 吗 ? 

(3) 下 面 的 代码 可 以 成 功 编译 吗 ? 为 什么 ? 


string[] blab = new string[5] 
blab[5] = 5th string. 


(4) 编写 一 个 控制 台 应 用 程序 ， 它 接收 用 户 输入 的 一 个 字符 串 ， 将 其 中 的 字符 以 与 输入 相反 的 顺序 输出 。 
(5) 编写 一 个 控制 台 应 用 程序 ， 它 接收 一 个 字符 串 ， 用 yes 蔡 换 字符 串 中 所 有 的 no. 

(6) 编写 一 个 控制 台 应 用 程序 ， 给 字符 串 中 的 每 个 单词 加 上 双 引 号 。 

附录 A 给 出 了 习题 答案 。 
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E 题 要 A 
值 可 以 从 一 种 类 型 转换 为 为 一 种 类 型 ， 但 在 转换 时 应 遵循 一 些 规则 。 隐 式 转 换 是 自动 进行 的 ， 但 只 有 当 源 值 类 型 
类 型 转换 的 所 有 可 能 值 都 可 以 在 目标 值 类 型 中 使 用 时 , 才能 进行 隐 式 转换 。 也 可 以 进行 显 式 转换 , 但 可 能 得 不 到 期 望 的 值 ， 
甚至 可 能 出 错 
枚 举 是 包含 一 组 离散 值 的 类 型 ， 每 个 离散 值 都 有 一 个 名 称 。 枚 举 用 enum 关键 字 定义 ， 以 便 在 代码 中 理解 它们 ， 
BE 因为 它们 的 可 读 性 都 很 强 。 枚 举 有 基本 的 数值 类 型 (默认 是 mb， 可 使 用 枚 举 值 的 这 个 属性 在 枚 举 值 和 数值 之 间 转 
换 ， 或 者 标识 枚 举 值 
结构 是 同时 包含 几 个 不 同 值 的 类 型 。 结 构 用 struct 关键 字 定 义 。 包 含 在 结构 中 的 每 个 值 都 有 名 称 和 类 型 ， 存 储 在 
结构 中 的 每 个 值 的 类 型 不 一 定 相 同 
数组 是 同类 型 数值 的 集合 。 数 组 有 固定 的 大 小 或 长 度 ， 确 定 了 数组 可 以 包含 多 少 个 值 。 可 以 定义 多 维 数 组 或 锯齿 


数组 来 保存 不 同 数量 和 形状 的 数据 。 还 可 以 使 用 foreach (AM AGE AAP AE 


REBAR: 

BU A ESCA ASE H BEA BESEEETRI BG 8, I EA 2305 EP] f] 5. ER C 
如 何在 函数 中 传人 和 传 出 数据 

使 用 变量 作用 域 

如 何 结合 使 用 Main0 函 数 和 命令 行 参 数 

如 何 把 函数 提供 为 结构 类 型 的 成 员 

如 何 使 用 函数 重 载 

如 何 使 用 委托 


本 章 源 代 码 下 载 : 

本 章 源 代码 可 以 通过 本 书 合 作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter06 文件 夹 中 并 已 根据 本 章 示 例 的 
名 称 单独 命名 。 


我 们 运 今 看 到 的 代码 都 是 以 单个 代码 块 的 形式 出 现 的 ， 其 中 包含 一 些 重复 执行 的 代码 行 ， 以 及 有 条 件 地 执 
行 的 分 支 语 句 。 如 果 要 对 数据 执行 茶 种 操作 ， 就 应 把 所 需要 的 代码 放 在 合适 的 地 方 。 

这 种 代码 结构 的 作用 是 有 限 的 。 条 些 任务 党 需要 在 一 个 程序 中 的 多 个 位 置 执行 , 例如 得 找 数组 中 的 最 大 值 。 
此 时 可 以 把 相同 (或 几乎 相同 ) 的 代码 块 按照 需要 放 在 应 用 程序 中 ， 但 这 样 做 存在 一 个 问题 。 对 于 和 彰 见 的 任务 ， 
即使 进行 非常 小 的 改动 (例如 ， 修 改革 个 代码 错误 )， 也 需要 修改 多 个 代码 块 ， 而 这 些 代码 块 可 能 散布 在 整个 应 
用 程序 中 。 如 果 息 了 修改 其 中 一 个 代码 块 ， 束 会 产生 很 大 有 影响， 导致 整个 应 用 程序 失败 。 男 外 ， 应 用 程序 也 较 长 。 

解决 这 个 问题 的 方法 是 使 用 函数 。 在 C# 中 ， 图 数 可 提供 在 应 用 程序 中 的 任何 一 处 执行 的 代码 块 。 

ER: 

本 章 介 绍 的 特定 类 型 的 函数 称 为 “方法 ”。 但 是 ， 这 个 术语 在 NET 编程 中 有 非常 特殊 的 含义 ， 本 书后 面 会 
详细 讨论 它 ， 所 以 现在 不 使 用 这 个 术语 。 

例如 ， 有 一 个 国 数 返回 数组 中 的 最 大 值 ， 可 在 代码 的 任何 位 置 使 用 这 个 函数 ， 且 在 每 个 地 方 都 使 用 相同 的 
代码 行 。 因 为 只 需要 提供 一 次 这 段 代 码 ， 所 以 对 代码 的 任何 修改 将 影 啊 使 用 该 国 数 进行 的 计算 。 这 个 函数 可 以 
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被 认为 包含 可 重用 的 代码 。 

函数 还 可 以 提 融 代码 的 可 读 性 ， 因 为 可 以 使 用 函数 将 相关 代码 组 合 在 一 起 。 这 样 ， 应 用 程序 主体 就 会 非 第 
短 ， 因 为 代码 的 内 部 工作 被 分 散 了 。 这 类 似 于 在 IDE 中 使 用 大 网 视 图 将 代码 区 域 打 登 在 一 起 ， 这 样 应 用 程序 的 
结构 更 加 合理 。 

函数 还 可 以 用 于 创建 多 用 途 的 代码 ， 让 它们 对 不 同 的 数据 执行 相同 的 操作 。 可 以 采用 参数 形式 为 函数 所 供 
信息 ， 以 返回 值 的 形式 得 到 函数 的 结果 。 在 上 面 的 示例 中 ， 参 数 束 是 一 个 要 搜索 的 数组 ， 而 返回 值 束 是 数组 中 
的 最 大 值 。 这 意味 看 每 次 可 以 使 用 同一 尔 数 处 理 不 同 的 数组 。 尔 数 的 定义 包括 尔 数 名 、 人 返回 类 型 以 及 一 个 参数 
列表 ， 这 个 参数 列表 指定 了 该 函数 需要 的 参数 数量 和 参数 类 型 。 函 数 的 名 称 和 参数 (不 是 返回 类 型 ) 共 同 定义 了 
图 数 的 签名 。 


6.1 定义 和 使 用 函数 


本 克 介 绍 如 何 将 函数 洪 加 到 应 用 程序 中 ， 以 及 如 何在 代码 中 使 用 (调用 ) 它 们 。 首 先 从 基础 知识 开始 ， 看 看 
不 与 调用 代码 交换 任何 数据 的 简单 函数 ， 然 后 介绍 更 局 级 的 图 数 用 法 。 首 先 分 析 一 个 示例 。 


试 一 试 TE MANE AAA LA: ChO6Ex01\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter06 目录 中 创建 一 个 新 的 控制 台 应 用 程序 ChO6Ex01. 
(2) 把 下 述 代码 添加 到 Program.cs "P: 
class Program 
static void Write () 
WriteLine ("Text output from function."); 
static void Main(string[] args) 
Write () ; 
ReadKey () ; 


} 
} 


(3) 执行 代码 ， 结 果 如 图 6-1 所 示 。 


图 6-1 


示例 说 明 
下 面 的 4 行 代码 定义 了 函数 Write): 
static void Write () 


WriteLine ("Text output from function."); 


这 些 代码 把 一 些 文本 输出 到 控制 台 窗 口中 。 但 此 时 这 些 并 不 重要 ， 我 们 更 关心 定义 和 使 用 函数 的 机 制 |。 
函数 定义 由 以 下 几 部 分 组 成 

e 两 个 关键 字 : static 和 void 

e 国 数 名 后 跟 圆 括号 ， 如 Write0 

e 一 个 要 执行 的 代码 块 ， 放 在 花 括 号 中 


注意 : 
一 般 采 用 PascalCase 形式 编写 函数 名 。 


定义 Write0 函 数 的 代码 非常 类 似 于 应 用 程序 中 的 其 他 代码 : 
Static void Main(string[] args) 


{ 
E 
这 是 因为 ， 到 目前 为 止 我 们 编写 的 所 有 代码 (类 型 定义 除外 ) 都 是 函数 的 一 部 分 。 函 数 Main0 是 控制 台 应 用 
程序 的 入 口 点 函数 。 当 执行 C# 应 用 程序 时 ， 就 会 调用 它 包含 的 入 口 点 函数 ， 这 个 函数 执行 完毕 后 ， 应 用 程序 就 
终止 了 。 所 有 C# 可 执行 代码 都 必须 有 一 个 入 口 扣 。 
Main0 函 数 和 Wirite0 函 数 的 唯一 区 别 (除了 它们 包含 的 代码 ) 是 函数 名 Main 后 面 的 圆 括号 中 还 有 一 些 代码 ， 
这 是 指定 参数 的 方式 ， 相 关内 容 详 见 后 面 的 内 容 。 
Main0 函 数 和 Write0 函 数 都 是 使 用 关键 字 static 和 void 定义 的 。 关 键 字 static 与 面向 对 象 的 概念 相关 ， 本 书 
在 后 面 讨论 。 现 在 只 需要 记 住 ， 本 节 的 应 用 程序 中 使 用 的 所 有 函数 都 必须 使 用 这 个 关键 字 。 
void 更 容易 解释 。 这 个 关键 字 表 明 函 数 没 有 返回 值 。 本 章 后 面 将 讨论 函数 有 返回 值 时 需要 编写 什么 代码 。 
继续 下 去 ， 调 用 函数 的 代码 如 下 所 示 : 


Write () 


键入 图 数 名 ， 后 跟 空 括号 即 可 。 当 程序 执行 到 这 行 代码 时 ， 残 会 运行 Write0 函 数 中 的 代码 。 


注意 : 


在 定义 和 调用 函数 时 ， 儿 须 使 用 圆 括号 。 如 果 删 除 它 们 ， 将 无 法 编译 代码 。 


6.1.1 返回 值 


通过 函数 进行 数据 交换 的 最 简单 方式 是 利用 返回 值 。 有 返回 值 的 函数 会 最 终 计 算得 到 这 个 值 ， 丈 像 在 表达 
式 中 使 用 变量 时 ， 会 计算 得 到 变量 包含 的 值 一 样 。 与 变量 一 样 ， 返 回 值 也 有 数据 类 型 。 
例如 ， 有 一 个 函数 GetStmng0， 其 返回 值 是 一 个 字符 串 ， 可 在 代码 中 使 用 该 图 数 ， 如 下 所 未: 


string myString; 
myString = GetString(); 


还 有 一 个 函数 GetVal0， 它 返回 一 个 double 值 ， 可 在 数学 表达 式 中 使 用 它 : 


double myVal; 
double multiplier = 5.3; 
myVal = GetVal() * multiplier; 


PK) ADR IB] — ^ RISE — DRH A P PRU SE ERR C 

e 在 国 数 声明 中 指定 返回 值 的 类 型 ， 但 不 使 用 关键 字 void. 

o 使 用 reum 关键 字 结 束 函 数 的 执行 ， 把 返回 值 传送 给 调用 代码 。 

从 代码 角度 看 ， 对 于 我 们 讨论 的 控制 全 应 用 程序 函数 ， 其 使 用 返回 值 的 形式 如 下 所 示 : 


static <returnType> <FunctionName> () 


{ 


return <returnValue>; 


} 

这 里 唯一 的 限制 是 <returnValue> 必 须 是 <returnzype> 类 型 的 值 ， 或 者 可 以 隐 式 转换 为 该 类 型 。 但 是 ， 
<return7ype> 可 以 是 任何 类 型 ， 包 括 前 面 介绍 的 较 复 林 类 型 。 这 段 代码 可 以 很 便 单 : 

static double GetVal () 


return 3.2; 


} 
但 是 ， 返 回 值 通常 是 函数 执行 的 一 些 处 理 的 结果 。 上 面 的 结果 使 用 const 变量 也 可 以 简单 地 实现 。 
当 执行 到 return 语句 时 ,程序 会 立即 返回 调用 代码 。 这 条 语句 后 面 的 代码 都 不 会 执行 。 但 这 并 不 意味 着 retum 
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语句 只 能 放 在 函数 体 的 最 后 一 行 。 可 以 在 前 边 的 代码 里 使 用 retum 语句 ， 例 如 放 在 分 文 逻 辑 之 后 。 把 return 语 
^J BUE for 循环 、 计 块 或 其 他 结构 中 会 使 该 结构 立即 终止 ,函数 也 立即 终止 。 例 如 : 
static double GetVal () 
{ 
double checkVal; 
// checkVal assigned a value through some logic (not shown here). 
if (checkVal « 5) 
return 4.7; 
return 3.2; 


} 
根据 checkVal 的 值 ， 将 返回 两 个 值 中 的 一 个 。 这 里 的 唯一 限制 是 ， 必 须 在 函数 的 闭合 花 插 号 } 之 前 处 理 
retum 语句 。 下 面 的 代码 是 不 合法 的 ; 

static double GetVal () 
{ 

double checkVal; 

// checkVal assigned a value through some logic. 

if (checkVal < 5) 

return 4.7; 


} 

如 果 checkVal>= 5, WERT SI return 语句 ， 这 是 不 允许 的 。 所 有 处 理 路 径 都 必须 执行 到 return 语句 。 
大 多 数 情况 下 ， 编 译 器 会 检 碍 是 否 执行 到 retum 语句 ， 如 果 没 有 ， 就 给 出 错误 “并 不 是 所 有 的 处 理 路 径 都 返回 
—^Mii ", 

执行 一 行 代码 的 图 数 可 使 用 C# 6 引入 的 一 个 功能 : 表达 式 体 方法 (expression-bodied method). VA F FR BUR 
式 使 用 = >(Lambda 箭头 ) 来 实现 这 一 功能 。 

static <returnType> <FunctionName>() => <myVall * myVal2>; 

fn, C#6-Z AVI Multiply Až F : 


static double Multiply (double myVall, double myVal2) 
{ 


} 
现在 可 以 使 用 = >CLambda 区 头 ) 编 写 它 。 下 述 代 码 用 更 简单 和 统一 的 方式 表达 方法 的 意图 : 


static double Multiply(double myVall, double myVal2) => mVall * MyVal2; 


return myVall * myVal2; 


612 参数 


HRGZ RUNE, DARED RAR: 
e 国 数 在 其 定义 中 指定 接 党 的 参数 列表 ， 以 及 这 些 参 数 的 类 型 。 
e 在 每 个 图 数 调用 中 提供 匹配 的 实 参 列表 。 


注意 : 

仔细 阅读 CH# 现 范 会 发 现形 参 (parameten 和 实 参 (areumenb 之 间 存 在 一 些 细微 的 区 别 : 形 参 是 函数 定义 的 一 部 
分 ， 而 实 参 则 由 调用 代码 传递 给 函数 。 但 是 ， 这 两 个 术语 通常 被 简单 地 称 为 参数 ， 似 乎 没有 人 对 此 感到 十 分 
不 满 。 


示例 代码 如 下 所 示 ， 其 中 可 以 有 任意 数量 的 参数 ， 每 个 参数 都 有 类 型 和 名 称 ; 


static <returnType> <FunctionName> (<paramType> <paramName>, ...) 


{ 


return <returnValue>; 


} 
ZU AE Slat. BTSRAME RATS PAE Ate, ADEN. Plan, Pi XE ih 
的 函数 ， 带 有 两 个 double 参数 ， 并 返回 它们 的 乘积 : 
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static double Product (double paraml, double param2) => paraml * param2; 


PMA TRE ARN ANB 


试 一 试 ”人 通过 函数 交换 数据 (1): ChO6Ex02\Program.cs 


(1) f£ C:\BeginningCSharp7\Chapter06 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch06Ex02。 
(2) 把 下 列 代 码 添 加 到 Program.cs 中 


class Program 
{ 
static int MaxValue(int[] intArray) 
{ 
int maxVal = intArray[0]; 
for (int i= 1; i < intArray.Length; i++) 
{ 
if (intArray[i] > maxVal) 
maxVal = intArray[i]; 
} 
return maxVal; 
} 
static void Main(string[] args) 
i 
int[] myArray = (1, 8, 3, 6,2, 5, 9, 3, 0, 2 Y; 
int maxVal = MaxValue (myArray) ; 
WriteLine($"The maximum value in myArray is {maxVal}"); 
ReadKey () ; 
} 
} 


(3) 执行 代码 ， 结 果 如 图 6-2 所 示 。 


6-2 


示例 说 明 
XBT BL 它 执 行 的 任务 束 古 本 章 开 头 的 示例 函数 所 完成 的 任务 。 该 函数 以 一 个 整数 数 
组 作为 参数 ， 并 返回 该 数组 中 的 最 大 值 。 该 函数 的 定义 如 下 所 示 : 
static int MaxValue(int[] intArray) 
{ 


int maxVal = intArray[0]; 
for (int 1 = 1; 1 < intArray.Length; i++) 


if (intArray[i] > maxVal) 


maxVal = intArray[il: 


} 


return maxVal; 


} 
函数 MaxValue0 定 义 了 一 个 参数 ， 即 int 数组 intArray， 它 还 有 一 个 int 类 型 的 返回 值 。 最 大 值 的 计算 是 很 
简单 的 。 局 部 获 型 变量 maxVal 初始 化 为 数组 中 的 第 一 个 值 ， 然 后 把 这 个 值 与 数组 中 后 面 的 每 个 元 系 依 次 进行 
比较 。 如 果 一 个 元 素 的 值 比 max Val 大 ， 就 用 这 个 值 代替 当前 的 max Val 值 。 循 环 结束 时 ，maxVal 就 包含 数组 中 
的 最 大 值 ， 用 return 语句 返回 。 
Main0 中 的 代码 声明 并 初始 化 一 个 简单 的 整数 数组 ， 用 于 Max Value() A 2X: 
int[] myArray = { 1, 8 d, B, 2, 5, By 3, Uy. 2 te 
调用 MaxValue0， 把 一 个 值 赋 给 int 变量 max Val: 
int maxVal = MaxValue (myArray); 


接着 ， 使 用 WsiteLine0 把 这 个 值 写 到 屏幕 上 : 


WriteLine($"The maximum value in myArray is {maxVal}"); 
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1. 参数 匹配 
在 调用 函数 时 ， 必 须 使 提供 的 参数 与 函数 定义 中 指定 的 参数 完全 匹配 ， 这 意味 看 要 匹配 参数 的 类 型 、 个 数 
和 顺序 。 例 如 ， 下 面 的 函数 : 


static void MyFunction(string myString, double myDouble) 
{ 


} 
不 能 使 用 下 面 的 代码 调用 : 
MyFunction(2.6, "Hello"); 


这 里 试图 把 一 个 double 值 作为 第 一 个 参数 传递 ， 把 string 值 作为 第 二 个 参数 传递 ， 参 数 顺 序 与 函数 声明 中 
定义 的 顺序 不 匹配 。 这 段 代 码 不 能 编 详 ， 因 为 参数 类 型 是 错误 的 。 本 章 后 面 的 6.5 他“ 函数 的 重 载 ” 将 介绍 解 
决 这 个 问题 的 一 种 有 效 技术 。 


2. 参数 数组 


C# 人 允许 为 图 数 指定 一 个 (只 能 指定 一 个 ) 特 殊 参 数 ， 这 个 参数 必须 是 图 数 定义 中 的 最 后 一 个 参数 ， 称 为 参数 
数组 。 参 数 数组 允许 使 用 个 数 不 定 的 参数 来 调用 函数 ， 可 使 用 params 关键 字 定义 它们 。 

参数 数组 可 以 简化 代码 ， 因 为 在 调用 代码 中 不 必 传 化 数组 ， 而 是 传人 递 同类 型 的 几 个 参数 ， 这 些 参 数 会 放 在 
可 在 函数 中 使 用 的 一 个 数组 中 。 

定义 使 用 参数 数组 的 函数 时 ， 需 要 使 用 下 列 代码 : 


static «returnType» <FunctionName> (<plType> <plName>, 
params «type»[] <name>) 


- mom 


{ 
— <returnValue>; 
} 
可 以 使 用 下 面 的 代码 调用 该 函数 : 
«FunctionName»(«pl1», ..., <vali>, «val2», ...) 


RKrpsval7fllsval2755 8e «type- AG VME, HAF IA <ame. BH) ATR ENS BT BU LP SE BR f, 
但 它们 都 必须 是 <type> 类 型 。 其 至 根本 不 必 指 定 参 数 。 
下 面 的 示例 定义 并 使 用 高 有 params 类 型 参数 的 函数 。 


试 一 试 ” 通 过 函数 交换 数据 (2): Ch06Ex03\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter06 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch06Ex03。 
(2) 把 下 述 代码 添加 到 Program.cs 中 : 
class Program 


static int SumVals (params int[] vals) 
int sum = 0; 

foreach (int val in vals) 

sum += val; 

T" sum; 


Static void Main(string[] args) 
{ 
int sum = SumVals(1, 5, 2, 9, 8); 
WriteLine($"Summed Values = {sum}"); 
ReadKey () ; 
} 
} 


(3) 执行 代码 ， 结 果 如 图 6-3 所 示 。 
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示例 说 明 

这 个 示例 用 关键 字 定义 函数 sumVals(), AeA BA) EL PESE TEXT int 参数 (但 不 接受 其 他 类 型 的 参数 ): 
static int SumVals(params int[] vals) 
{ 
i — 

这 个 函数 对 vals BAPE RET IAN, REE ik, BERAR. 

f£ Main), H 5 PRES Acid A ER 2C SumVals(): 


int sum = SumVals(1, 5, 2, 9, 8); 


也 可 以 用 0、1、2 或 100 “AY 22 2508] FE OT ERI C 22 2901] Bt AS Se BRR ilo 


注意 : 
CH 引入 了 指定 函数 参数 的 新 方式 ， 包 括 用 一 种 可 读 性 更 好 的 方式 来 包含 可 选 参数 。 第 13 章 将 介绍 这 些 方 


3. 引用 参数 和 值 参数 

本 章 迄 今 定 义 的 所 有 国 数 者 市 有 值 参数 。 其 会 义 是 : 在 使 用 参数 时 ， 是 把 一 个 值 传 弟 给 尔 数 所 使 用 的 一 个 
变量 。 在 函数 中 对 此 变量 的 任何 修改 都 不 影响 函数 调用 中 指定 的 参数 。 例 如 ， 下 面 的 函数 使 传递 过 来 的 参数 值 
加 倍 ， 并 显示 出 来 : 

static void ShowDouble(int val) 

i val *= 2; 


WriteLine($"val doubled = {val}"); 
} 
参数 val 在 这 个 国 数 中 被 加 倍 ， 如 条 按 以 下 方式 调用 它 : 
int myNumber = 5; 
WriteLine($"myNumber = {myNumber}"); 
ShowDouble (myNumber) ; 
WriteLine($"myNumber = {myNumber}"); 


输出 到 控制 台 的 文本 如 下 所 示 : 

myNumber = 5 

val doubled = 10 

myNumber = 5 

把 myNumber 作为 一 个 参数 ， 调 用 ShowDouble0 并 不 影响 Main0 中 myNumber 的 值 ， 即 使 把 myNumber 
赋值 给 val 后 再 将 val 加 倍 ，myNumber 的 值 也 不 变 。 

这 很 不 错 ， 但 如 果 要 改变 myNumber 的 值 ， 就 会 有 问题 。 可 以 使 用 一 个 为 myNumber 返回 新 值 的 图 数 ， 如 
下 所 示 : 

static int DoubleNum(int val) 

i val *= 2; 

return val; 


| 
并 使 用 下 面 的 代码 调用 它 : 


int myNumber = 5; 
WriteLine($"myNumber = {myNumber}"); 
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myNumber = DoubleNum ( r); 
WriteLine($"myNumber = {myNumber}"); 


(EXECS — tA EDU, HAREE FA a Te Bet (ALAR RA AMR). 

此 时 可 以 通过 “引用 ”传递 参数 。 即 国 数 处 理 的 变量 与 图 数 调用 中 使 用 的 变量 相同 ， 而 不 仅仅 是 值 相同 的 
变量 。 因 此 ， 对 这 个 变量 进行 的 任何 改变 都 会 影响 用 作 参 数 的 变量 值 。 为 此 ， 只 需要 使 用 ref 关键 字 指定 参数 : 

static void ShowDouble(ref int val) 

val *= 2; 

l WriteLine($"val doubled = {val}"); 

在 尔 数 调用 中 骨 次 指定 它 ( 这 是 必需 的 ): 


int myNumber = 5; 
WriteLine($"myNumber = {myNumber}"); 
ShowDouble (ref myNumber) ; 

WriteLine ($"myNumber = {myNumber}"); 


得 出 到 控制 台 的 文本 现在 如 下 所 示 : 


myNumber = 5 
val doubled = 10 
myNumber = 10 


注意 ， 用 作 ref 参数 的 变量 有 两 个 限制 。 首 先 ， 函 数 可 能 会 改变 引用 参数 的 值 ， 所 以 必须 在 函数 调用 中 使 
用 “非常 量 ” 变 量 。 所 以 ， 下 面 的 代码 是 非法 的 : 

const int myNumber = 5; 

WriteLine($"myNumber = (myNumber]"); 


ShowDouble (ref myNumber); 
WriteLine($"myNumber = (myNumber]"); 


其 次 ， 必 须 使 用 初始 化 过 的 变量 。C# 不 允许 假定 ref 参数 在 使 用 它 的 函数 中 初始 化 ， 下 面 的 代码 也 是 非 
iiit: 


int myNumber; 
ShowDouble(ref myNumber); 
WriteLine("myNumber = {myNumber}"); 


到 目前 为 止 ， 只 看 到 了 将 ref 关键 字 用 于 国 数 参数 的 情况 ， 但 也 可 以 将 它 应 用 于 局 部 变量 和 返回 值 。 此 处 
的 myNumberRef 引用 myNumber, 修改 myNumberRef 也 会 导致 myNumber 发 生变 化 。 如 果 显 示 myNumber 和 
myNumberRef 的 值 ， 则 将 看 到 两 个 变量 的 值 都 为 6。 

int myNumber = 5; 

ref int myNumberRef = ref myNumber; 

myNumberRef = 6; 

也 可 以 将 ref 关键 字 用 作 返 回 类 型 。 注 意 以 下 代码 中 的 ref 关键 字 将 返回 类 型 标识 为 ref int， 且 代码 体 中 也 
使 用 了 ref, ihe 20 [H] ref val. 

static ref int ShowDouble(int val) 

i val *= 2; 

return ref val; 

} 

a A Rawr EAA, CRI iB. MAEPS HSA, AEA HAHA ref 
关键 字 ， 就 不 能 将 变量 类 型 作为 函数 参数 传递 。 碍 看 下 面 添 加 了 ref KRESS, em BCI 9 VEO T IZ 
预期 的 那样 运行 。 

static ref int ShowDouble(ref int val) 

Val *= 2; 

return ref val; 
} 
strings 和 arrays 这 样 的 变量 是 引用 类 型 ， 在 没有 参数 声明 的 情况 下 使 用 ref 关键 字 可 以 返回 arrays. 


static ref int ReturnByRef () 


int[] array = { 2 }; 


return ref array[0];: 


} 


注意 : 


虽然 strings 是 引用 类 型 ， 但 属于 特例 ， 因 为 它们 是 不 可 改变 的 。 修 改 它 们 会 产生 新 的 string, MA ty string 
则 会 被 解除 分 配 。 如 果 试 图 通过 ref 返回 string， 则 C# 编 译 器 Roslyn 会 报错 。 


4. 输出 参数 

除了 按 引 用 传递 值 外 ， 还 可 以 使 用 out 关键 字 ， 指 定 所 给 的 参数 是 一 个 输出 参数 。out 关键 字 的 使 用 方式 与 
ref 关键 字 相 同 (在 函数 定义 和 函数 调用 中 用 作 参 数 的 修饰 符 )。 实际 上 , 它 的 执行 方式 与 引用 参数 几乎 完全 一 样 ， 
因为 在 函数 执行 完毕 后 ， 该 参数 的 值 将 返回 给 函数 调用 中 使 用 的 变量 。 但 是 ， 二 者 存在 一 些 重 要 区 别 : 

e 把 未 赋值 的 变量 用 作 ref 参数 是 非法 的 ， 但 可 以 把 未 赋值 的 变量 用 作 out 参数 。 

e 尺 外 ， 在 函数 使 用 out 参数 时 ， 必 须 把 它 看 成 尚未 赋值 。 

即 调用 代码 可 以 把 已 赋值 的 变量 用 作 out 参数 ， 但 存储 在 该 变量 中 的 值 会 在 函数 执行 时 丢失 。 

例如 ， 考 虑 前 面 返回 数组 中 最 大 值 的 MaxValue0 图 数 ， 略 微 修改 该 函数 ， 获 取 数 组 中 最 大 值 的 元 紊 索引 。 
为 简单 起 见 ， 如 果 数 组 中 有 多 个 元 素 的 值 都 是 这 个 最 大 值 ， 只 提取 第 一 个 最 大 值 的 索引 。 为 此 ， 修 改 函 数 ， 添 
加 一 个 out 参数 ， 如 下 所 示 : 


static int MaxValue(int[] intArray, out int maxIndex) 
{ 
int maxVal = intArray[0]; 
maxlIndex = 0; 
for (int i = 1; i < intArray.Length; i++) 
{ 
if (intArray[i] > maxVal) 
J maxVal = intArray[il? 
maxlIndex = i; 
) 
} 
return maxVal; 
} 
PRHA FAITS A 1 RAR: 
1nt[] myArray = { 1, H. d, 6: 2, Sy M, Sy 0, 2 LB 
WriteLine("The maximum value in myArray is " + 
S"[MaxValue(myArray, out int maxIndex) }"); 
WriteLine("The first occurrence of this value is " + 
S" at element {maxIndex + 1]"); 


结果 如 下 : 


The maximum value in myArray 15 9 
The first occurrence of this value is at element 7 


注意 ， 必 须 在 函数 调用 中 使 用 out KEF, WR ref 关键 字 一 样 。 当 解析 数据 时 out 关键 字 也 非常 有 用 ， 如 
下 所 示 : 

if (!int.TryParse(input, out int result)) 

)j return null; 

return result; 

这 段 代码 检查 input 变量 中 存储 的 值 是 不 是 整 型 值 。 如 果 不 是 , 则 返回 null 值 ; 如 果 是 , 则 通过 声明 为 result 
的 out 变量 同调 用 函数 返回 整 型 值 。 

5. 元 组 

从 函数 中 人 返回 多 个 值 有 多 种 方法 。 例 如 ， 可 用 使 用 前 面 讨论 的 out 关键 字 、 结 构 或 数组 ， 也 可 用 使 用 本 章 
后 面 将 讨论 的 类 。 昌 然 使 用 out 关键 字 可 以 达到 此 目的 ,但 这 样 使 用 该 关键 字 并 不 是 它 最 初 的 设计 用 途 。 记 住 ， 
out 关键 字 旨 在 通过 引用 传递 参数 ， 而 不 必 事 先 初始 化 它 。 而 结构 、 数 组 和 类 都 是 有 效 的 选择 ， 但 需要 额外 编 
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写 代码 来 创建 、 初 始 化 、 引 用 和 读 取 它们 。 相 比 之 下 ， 使 用 元 组 则 是 达到 此 目的 的 一 种 非常 优雅 的 方法 ， 且 只 
需要 很 小 的 开销 。 

因为 元 组 提供 了 一 种 非常 方便 和 直接 的 方法 来 从 函数 中 返回 多 个 值 ,在 程序 不 需要 结构 或 更 复杂 的 实现 时 ， 
使 用 元 组 非常 有 效 。 如 下 面 的 简单 示例 所 示 : 

var numbers = (1, 2, 3, 4, 5)? 

上 面 的 代码 创建 了 一 个 名 为 numbers 的 元 组 ， 其 中 包含 成 员 Item1. Item2. Item3. Item4 和 Item5, HRH 
下 面 的 方式 来 访问 这 些 成 员 : 

var number = numbers.Iteml; 

如 果 要 给 这 些 成 员 指 定 特 定 的 名 称 ， 可 以 明确 地 标识 它们 : 


(int one, int two, int three, int four, int five) nums = (1, 2, 3, 4, 5); 
int first = nums.one; 


方法 声明 看 起 来 应 该 如 下 所 示 : 


private static (int max, int min, double average) 
GetMaxMin (IEnumerable<int> numbers) 
{ 
return (Enumerable.Max (numbers), 
Enumerable.Min(numbers), 
Enumerable.Average (numbers) ); 


然后 ， 在 简单 的 控制 台 应 用 程序 运行 下 面 的 代码 : 


static void Main(string[] args) 
{ 
IEnumerable«int» numbers = new int[] { 1, 2, 3, 4, 5, 6 }? 
Var result = GetMaxMin (numbers) ; 
WriteLine($"Max number is [result.max], " + 
S"Min number is {result.min}, ”十 
s"Average is {result.average}"); 
ReadLine(); 


) 
运行 结果 如 图 6-4 Ata. 


注意 : 
第 10 章 将 介绍 类 和 成 员 的 创建 方法 ,那里 会 给 出 一 个 有 关 元 组 析 构 的 示例 。 要 彻底 理解 这 个 概念 ， 就 必须 
理解 类 的 一 些 基本 原理 ， 所 以 应 该 继续 阅读 ， 并 知道 在 第 10 章 将 继续 介绍 元 组 。 


62 ”变量 的 作用 域 


在 上 一 市 中 , 读者 可 能 想 知 道 为 什么 需要 利用 函数 来 交换 数据 。 原因 是 C# 中 的 变量 仅 能 从 代码 的 本 地 作用 
域 访问 。 给 定 的 变量 有 一 个 作用 域 ， 在 这 个 作用 域外 是 不 能 访问 该 变量 的 。 

变量 的 作用 域 是 一 个 重要 主题 ， 最 好 用 一 个 示例 加 以 说 明 。 下 例 将 演示 在 一 个 作用 域 中 定义 变量 ， 但 试图 
在 男 一 个 作用 域 中 使 用 该 变量 的 情形 。 


试 一 试 ”变量 的 作用 域 : ChO6Ex01\Program.cs 


(1) 对 Ch06Ex01 中 的 Program.cs 执行 如 下 修改 : 


class Program 
{ 


static void Write () 
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{ 
WriteLine ($"myString = {myString}"); 

} 

static void Main(string[] args) 

{ 
string myString = "String defined in Main()"; 
Write (); 
ReadKey () ; 

} 

} 


(2) 编译 代码 ， 注 意 显 示 在 错误 列表 中 的 错误 和 鞭 告 : 


The name 'myString' does not exist in the current context 
The variable 'myString' is assigned but its value is never used 


示例 说 明 

什么 地 方 出 错 了 ? 不 能 在 Write0 函 数 中 访问 在 应 用 程序 主体 (Main0 函 数 ) 中 定义 的 变量 myString。 

原因 在 于 变量 是 有 作用 域 的 ， 在 相应 作用 域 中 ， 变 量 才 是 有 效 的 。 这 个 作用 域 包括 定义 变量 的 代码 块 和 直接 髓 套 
在 其 中 的 代码 块 。 函 数 中 的 代码 块 与 调用 它们 的 代码 块 是 不 同 的 。 在 Write0 中 ， 没 有 定义 myString， 在 Main) 
中 定义 的 myString 变量 则 超出 了 作用 域 一 - 它 只 能 在 Main0 中 使 用 。 

实际 上 ， 在 Write0 中 可 以 有 一 个 完全 独立 的 变量 myString。 修 改 代码 ， 如 下 所 示 : 


class Program 
{ 
static void Write () 
{ 
string myString = "String defined in Write()"; 
WriteLine ("Now in Write()"); 
WriteLine($"myString = {myString}"); 


static void Main(string[] args) 

{ 
string myString = "String defined in Main()"; 
Write(); 
WriteLine ("\nNow in Main()"); 
WriteLine($"myString = {myString}"); 
ReadKey () ; 


} 
这 段 代 码 就 可 以 编译 ， 输 出 结果 如 图 6-5 所 示 。 


图 6-5 


这 段 代码 执行 的 操作 如 下 : 
Main0 定 义 和 初 始 化 字符 串 变 量 myString。 
Main0 把 控制 权 传送 给 Write(). 
Write0 定 义 和 初 始 化 字符 串 变 量 myString， 它 与 Main0 中 定义 的 myStnmng 变量 完全 不 同 。 
Write0 把 一 个 字符 串 输 出 到 控制 台 ， 该 字符 串 包 仿 在 Write0 中 定义 的 myString 的 值 。 
Wirite0 把 控制 权 传送 回 Main(). 
Main0 把 一 个 字符 串 输 出 到 控制 台 ， 该 字符 串 包含 在 Main0 中 定义 的 myString 的 值 。 
其 作用 域 以 这 种 方式 覆盖 一 个 函数 的 变量 称 为 局 部 变量 。 还 有 一 种 全 局 变量 ， 其 作用 域 可 履 盖 多 个 函数 。 
修改 代码 ， 如 下 所 示 : 


class Program 


{ 
static string myString; 
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static void Write () 

{ 
string myString = "String defined in Write()"; 
WriteLine("Now in Write()"): 
WriteLine($"Local myString = {myString}"); 
WriteLine($"Global myString = {Program.myString}") ; 

} 

static void Main(string[] args) 

{ 
string myString = "String defined in Main()"; 
Program.myString = "Global string"; 
Write (); 
WriteLine ("\nNow in Main()"); 
WriteLine ($"Local myString = (myString)"); 
WriteLine ($"Global myString = {Program.myString}") ; 
ReadKey (); 

} 

} 


执行 结果 如 图 6-6 所 示 。 


图 6-6 


这 里 添加 了 为 一 个 变量 myStrng， 这 次 进一步 加 深 了 代码 中 的 名 称 层次 。 这 个 变量 定义 如 下 : 
static string myString; 


注意， 这 里 也 需要 static 关键 字 。 读 者 只 需 理 解 在 此 类 控制 台 应 用 程序 中 ， 必 须 使 用 static 或 const KEF 
来 定义 这 种 形式 的 全 局 变量 ， 而 不 必 了 解 更 多 细节 。 如 果 要 修改 全 局 变量 的 什 ， 就 需要 使 用 static， 因 为 const 
禁止 修改 变量 的 值 。 

为 区 分 这 个 变量 和 Main0 与 Write0 中 的 同名 局 部 变量 ， 必 须 用 一 个 完全 限定 的 名 称 为 变量 名 分 类 ， 参 见 第 
3 章 。 这 里 把 全 局 变量 称 为 Program.myString。 注 意 ， 只 有 在 全 局 变量 和 局 部 变量 同名 时 ， 才 需要 这 人 么 做 。 如 果 
没有 局 部 myString $Œ, WH LTH myString 表示 全 局 变量 ， 而 不 需要 使 用 Program.myString。 如 果 局 部 变量 
和 全 局 变量 同名 ， 会 屏蔽 全 局 变量 。 

全 局 变量 的 值 在 Main0 中 设置 如 下 : 


Program.myString = "Global string"; 
全 局 变量 在 Write0 中 可 以 通过 如 下 语句 访问 : 
WriteLine ($"Global myString = {Program.myString}"); 
为 什么 不 能 使 用 这 种 技术 通过 函数 来 交换 数据 ， 而 要 使 用 前 面 介绍 的 参数 来 交换 数据 ? 有 时 ， 这 确实 是 一 种 交 
换 数据 的 自选 方式 ， 例 如 编写 一 个 对 象 ， 用 作 插 件 ， 或 者 在 较 大 项 目 中 使 用 的 短 脚本 。 但 许多 情况 下 不 应 使 用 这 种 
方式 。 使 用 全 局 变量 的 最 常见 问题 与 并 发 性 的 管理 相关 。 例 如 ， 可 以 编写 一 个 全 局 变量 来 读 取 一 个 类 的 众多 方法 或 
读 取 不 同 的 线程 。 如 果 大 量 的 线程 和 方法 可 以 写 入 全 局 变量 ， 能 确定 全 局 变量 中 的 值 是 有 效 数 据 吗 ? 没有 额外 的 同 
步 代码 ， 就 不 能 确定 。 此 外 ， 一 段 时 间 过 去 后 ， 可 能 会 忘记 最 初 使 用 全 局 变量 的 真正 意图 ， 而 将 其 用 于 其 他 目的 。 
因此 ， 是 任 使 用 全 局 变量 取决 于 函数 的 用 途 。 
使 用 全 局 变量 的 问题 在 于 ， 它 们 通常 不 适用 于 “常规 用 途 ” 的 函数 一 这些 函 数 能 处 理 我 们 所 提供 的 任意 数据 ， 
而 不 仅 限于 处 理 特定 全 局 变量 中 的 数据 。 详 见 本 章 后 面 的 内 容 。 


6.2.1 其 他 结构 中 变量 的 作用 域 


上 一 节 的 一 个 要 点 并 不 只 是 与 函数 之 间 的 变量 作用 域 有 关 : 变量 的 作用 域 包含 定义 它们 的 代码 块 和 直接 嵌 矢 
在 其 中 的 代码 块 。 接 下 来 要 讨论 的 代码 可 在 本 和 章 下 载 文件 的 VariableScopeInLoops\Program.cs 中 找到 。 这 一 点 也 
运用 于 其 他 代码 块 ， 例 如 分 文 和 循环 结构 的 代码 块 。 考 虑 下 面 的 代码 : 

ü = 0; i < 10; i++) 

string text = $"Line {Convert.ToString(1)}"; 

WriteLine (S"{text}"); 


— text output in loop: {text}"); 

字符 串 变 量 text 是 for (BRI S BEAL, ECA EMP, EATE AEI UBI 
试图 使 用 该 字符 串 变量 ， 但 是 在 循环 外 部 该 字符 串 变 量 会 超出 作用 域 。 修 改 代码 ， 如 下 所 示 : 

cud text; 

for (1 = 0; 1 < 10; i++) 

{ 


text = $"Line {Convert.ToString(i)}"; 
WriteLine($"[text]"); 


用 的 WriteLine( 


} 
WriteLine($"Last text output in loop: {text}"); 
这 段 代 码 也 会 失败 ， 原 因 是 必须 在 使 用 变量 前 对 其 进行 声明 和 初始 化 ， 但 text 只 在 for 循环 中 进行 了 初始 
化 。 由 于 没有 在 循环 外 进行 初始 化 ， 因 此 赋 给 text 的 值 在 循环 块 退出 时 就 丢失 了 。 但 可 以 进行 如 下 修改 : 
int i; 
string text = ""; 
for (120; 1 < 10; i++) 
{ 
text = $"Line {Convert.ToString(i)}"; 
WriteLine ($"{text}"); 


} 
WriteLine($"Last text output in loop: {text}"); 


这 次 text 是 在 循环 外 部 初始 化 的 ， 所 以 可 以 访问 它 的 值 。 这 段 简单 代码 的 执行 结果 如 图 6-7 所 示 。 


图 6-7 


在 循环 中 最 后 赋 给 text 的 值 可 以 在 循环 外 部 访问 。 可 以 看 出 ， 这 个 主题 的 内 容 需 要 花 一 点 时 间 来 掌握 。 在 
前 面 的 示例 中 ， 循 环 之 前 将 空 字符 串 赋 给 text， 而 在 循环 之 后 的 代码 中 ，text 就 不 会 是 空 字符 串 了 ， 其 原因 可 能 
一 下 子 看 不 出 来 。 

这 种 情况 的 解释 涉及 分 配给 text 变量 的 内 存 空间 , 实际 上 任何 变量 都 是 这 样 。 只 声明 一 个 简单 的 变量 类 型 ， 
并 不 会 引起 其 他 变化 。 只 有 在 给 变量 赋值 后 ， 这 个 值 才 会 被 分 配 一 块 内 存 空间 。 如 果 这 种 分 配 内 存 空间 的 行为 
在 循环 中 友 生 ， 该 值 实际 上 被 定义 为 一 个 局 部 值 ， 在 循环 外 部 会 超出 其 作用 域 。 

即使 变量 本 号 未 局 部 化 到 循环 上 ， 其 包含 的 值 却 会 局 部 化 到 该 循环 上 。 但 在 循环 外 部 赋值 可 以 确保 该 值 是 
主体 代码 的 局 部 值 ， 在 循环 内 部 它 仍 处 于 其 作用 域 中 。 这 意味 看 变量 在 退出 主体 代码 块 之 前 是 没有 超出 作用 域 
的 ， 所 以 可 在 循环 外 部 访问 它 的 值 。 
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Sef, CHa Aas nu] frd] eae EA IR] BR, A EE VA T e I IE EE BATT Ee AE E NE H E 
问题 。 


622 参数 和 返回 值 与 全 局 数据 
本 市 将 详细 介绍 如 何 通 过 全 局 数据 以 及 参数 和 返回 值 与 函数 交换 数据 。 自 先 分 析 下 面 的 代码 : 


class Program 
static void ShowDouble(ref int val) 
{ 


val *— 2; 
WriteLine($"val doubled = {val}"); 

static void Main(string[] args) 

{ 
int val = 5; 
WriteLine($"val = {val}"); 
ShowDouble (ref val); 
WriteLine($"val = {val}"); 

} 

} 


注意 : 
这 段 代码 与 本 章 前 面 的 代码 稍 有 不 同 ， 在 前 面 的 示例 中 ， 在 Main0 中 使 用 了 变量 名 myNumber， 这 说 明 局 
部 变量 可 以 具有 相同 的 名 称 ， 且 不 会 相互 干涉 。 


将 上 面 的 代码 与 下 面 的 代码 相 比较 : 
class Program 


static int val; 
static void ShowDouble() 
m ; 
WriteLine($"val doubled = {val}"); 
static void Main(string[] args) 
val — 5; 
WriteLine(S"val = {val}"); 
ShowDouble (); 
WriteLine ($"val = {val}");3 
} | 
这 两 个 ShowDouble0 函 数 的 结果 是 相同 的 。 
使 用 哪 种 方法 并 没有 什么 硬性 规定 ， 这 两 种 方法 都 十 分 有 效 ， 但 需要 考虑 如 下 一 些 规则 。 
自 先 ， 在 第 一 次 讨论 这 个 问题 时 束 提 到 过 ， 使 用 全 局 值 的 ShowDouble0 版 本 只 使 用 全 局 变量 val。 为 使 用 
这 个 版 本 ， 必 须 使 用 这 个 全 局 变量 。 这 会 对 该 函数 的 灵活 性 有 轻微 的 限制 ， 如 果 要 存储 结果 ， 束 必须 总 是 把 这 
个 全 局 变量 值 复制 到 其 他 变量 中 。 男 外 ， 全 局 数据 可 能 在 应 用 程序 的 其 他 地 方 被 代码 修改 ， 这 会 叶 致 预料 不 到 
的 结果 (其 值 可 能 会 改变 ， 等 我 们 认识 到 这 一 反 时 为 时 已 晚 )。 
当然 ， 也 可 以 说 ， 这 种 简化 实际 上 使 代码 更 难 理解 。 显 式 指 定 参数 可 以 一 眼看 出 发 生 了 什么 改变 。 例 如 对 
T FunctionName(vall, out val2) 国 数 调用 ， 马 上 束 可 以 知道 vall 和 val2 都 是 要 考虑 的 重要 变量 ， 在 图 数 执行 完 
Ja, 2A val2 赋予 一 个 新 值 。 反 之 ， 如 末 这 个 函数 不 市 参数 ， 束 不 能 对 它 处 理 了 什么 数据 做 任何 假设 。 
忆 之 ， 可 以 目 由 选择 使 用 哪 种 技术 来 交换 数 据 。 一 般 情 况 下 ， 最 好 使 用 参数 ， 而 不 使 用 全 局 数据 ， 但 有 时 
使 用 全 局 数据 可 能 更 合适 ， 使 用 这 种 技术 并 没有 和 错 。 


62.3 ”局 部 函数 
本 章 开 头 部 分 介绍 了 函数 的 概念 ， 提 到 了 从 Main(string[] args) 函 数 中 提取 出 代码 的 原因 在 于 ， 可 在 同一 程 
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序 中 复 用 这 些 提 取出 的 代码 ， 而 不 必 多 次 编写 它们 。 在 此 想 要 强调 的 是 ， 在 大 多 数 情 况 下 设计 和 创建 程序 时 ， 
应 该 都 要 遵循 这 种 思维 方式 。 
注意 随 者 时 间 的 流 渤 ， 人 们 期 户 程 序 做 的 事情 越 来 越 多 ， 所 以 程序 会 变 得 越 来 越 复杂 。 随 看 程序 功能 人 不断 
增加 ， 会 导致 开 有 友人 员 在 程序 中 添加 更 多 国 数 。 而 程序 拥有 的 函数 越 多 ， 对 其 他 开 有 友人 员 而 言 ， 修 改 (如 修复 
bug 或 添加 新 功能 ) 的 难度 融会 越 大 。 这 不 仅 是 因为 函数 量 的 增加 ， 还 因为 函数 的 最 初 意图 被 遗 未。 这 梓 一 来 ， 
有 些 图 数 就 可 能 不 按 创 建 者 的 最 急 意 图 ， 被 用 于 其 他 目的 ， 这 梓 在 错误 修改 它们 后 就 会 导致 严重 问题 。 
如 果 友 现 需 要 对 他 人 所 编写 的 函数 进行 修改 ， 可 以 考虑 使 用 局 部 函数 。 局 部 冰 数 允许 在 男 一 个 函数 的 上 下 
文中 声明 一 个 图 数 ， 这 样 做 有 助 于 提高 程序 的 可 谈 性 ， 让 他 人 快速 理解 程序 的 目的 。 
以 下 面 的 代码 为 例 : 
class Program 
static void Main(string[] args) 
i int myNumber = 5; 
WriteLine($"Main Function = {myNumber}"); 


DoubleIt (myNumber) ; 
ReadLine(); 


void DoubleIt (int val) 


val *— 2; 
WriteLine ($"Local Function - val = {val}"); 
} 
} 
} 


YEE, DoubleltQ Až Æ F Main(string[] args) ER AC. ABE Program 类 中 的 其 他 函数 中 调 
Ex fe] FANS 47 55 0 Un d 6-8 所 示 。 


图 6-8 


最 后 要 记 住 的 是 ， 在 函数 声明 的 前 面 添加 asyne ES n] LAGS Fr 2b ABER FE aE eT ee, 
虽然 本 书 中 未 介绍 ， 但 应 该 知道 它 的 功能 是 非常 强大 的 。 


6.3 Main( ELS 


前 和 面 介绍 了 创建 和 使 用 函数 时 涉及 的 大 多 数 人 简单 技术 ， 下 面 详细 论述 Maino AZ. 

Main0 是 C# 应 用 程序 的 入 口 点 ， 执 行 这 个 函数 就 是 执行 应 用 程序 。 也 就 是 说 ， 在 执行 过 程 开 始 时 ， 会 执行 
Main) ARG Œ Main0 函 数 执行 完毕 时 ， 执 行 过 程 就 结束。 

这 个 函数 可 以 返回 void 或 int， 有 一 个 可 选 参数 string[] args。Main0 函 数 可 使 用 如 下 4 种 版 本 : 

static void Main() 

static void Main(string[] args) 


static int Main() 
static int Main(string[] args) 


上 面 的 第 3 个 和 第 4 个 版 本 返回 一 个 int 值 ， 它 们 可 以 用 于 表示 应 用 程序 的 终止 方式 ， 通 常用 作 一 种 错误 
提示 (但 这 不 是 强制 的 )。 一般 情况 下 , 返回 0 反映 了 “正常 ”的 终止 即 应 用 程序 已 经 执行 完毕 ， 并 安全 地 终止 )。 

Main0 的 可 选 参数 args 提供 了 一 种 从 应 用 程序 的 外 部 接受 信息 的 方法 ， 这 些 信息 在 运行 应 用 程序 时 以 命令 
行 参数 的 形式 指定 。 

在 执行 控制 台 应 用 程序 时 ， 指 定 的 任何 命令 行 参数 都 放 在 这 个 args 数组 中 ,之 后 可 以 根据 需要 在 应 用 程序 
中 使 用 这 些 参数 。 下 面 用 一 个 示例 来 说 明 。 这 个 示例 可 以 指定 任意 数量 的 命令 行 参数 ， 每 个 参数 都 被 输出 到 控 
制 台 。 
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试 一 试 “命令 行人 参数 : ChO6Ex04\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter06 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch06Ex04。 
(2) 把 下 列 代码 添加 到 Program.cs 中 : 


class Program 


{ 
static void Main(string[] args) 
{ 
WriteLine($"[args.Length) command line arguments were specified:") ; 
foreach (string arg in args) 
WriteLine (arg) ; 
ReadKey () ; 
} 
} 


(3) 打开 项 目的 属性 页 面 (在 Solution Explorer 窗口 中 右 击 Ch06Ex04 项 目 名称 ， 然 后 选择 Properties 选项 )。 
(4) 选择 Debug 页 面 ， 在 Command line arguments 设置 中 添加 所 希望 的 命令 行 参数 ， 如 图 6-9 所 示 。 
[ENS — | | | | | |— 


Appi 
ppiicauon Configuration: Active (Debug) Y Platform: Active (Any CPU) 
Build 


Build Events Start action 


Debug @ Start project 
Resources 
(C) Start external program: 
Services 
Settings ©) Start browser with URL: 
Rete Path 
mo ES Start options 
Signing 
Command line arguments: , | . roui m 
Security g 256 myfile.txt "a longer argument 
Publish 


Code Analysis 
Working directory: 


[ ] Use remote machine 
Debugger engines 
[ | Enable native code debugging 


[ ] Enable SQL Server debugging 


图 6-9 


(5) 运行 应 用 程序 ， 输 出 结果 如 图 6-10 所 示 。 


器 ri 


图 6-10 


示例 说 明 
这 里 使 用 的 代码 非 营 简单 : 


WriteLine ($"{args.Length} command line arguments were specified:"); 
foreach (string arg in args) 
WriteLine (arg); 


使 用 args 参数 与 使 用 其 他 字符 串 数组 类 似 。 我 们 没有 对 参数 进行 任何 异样 的 操作 ， 只 是 把 指定 信息 写 到 
Sear. EAP P, WW IDE 中 的 项 目 属性 提供 参数 ， 这 是 一 种 便捷 方式 ， 只 要 在 DE 中 运行 应 用 程序 ， 驳 
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可 以 使 用 相同 的 命令 行 参 数 ， 不 必 每 次 都 在 命令 行 提示 窗口 中 键入 它们 。 在 项 目 输出 所 在 的 目录 (Ci*\ 
BeginningCSharpp7\Chapter06\Ch06Ex04\Ch06Ex04\bin\Debug) 下 打开 命令 提示 窗口 ， 刍 入 下 述 代 码 ， 也 可 以 得 到 
同样 的 结果 : 

ChO6Ex04 256 myFile.txt "a longer argument" 

每 个 参数 都 用 空格 分 开 。 如 果 参 数 包 含 空 格 ， 束 可 以 用 双 引 号 把 参数 括 起 来 ， 这 样 才 不 会 把 这 个 参数 解释 
为 多 个 参数 。 


6.4 结构 函数 


第 5 半 介 绍 了 结构 类 型 ， 它 可 在 一 个 地 方 存储 多 个 数据 元 素 ， 但 实际 上 结构 可 以 做 的 工作 远 不 止 这 一 点 。 
例如 ， 除 了 数据 ， 结 构 还 可 以 包含 国 数 。 这 初 看 起 来 很 奇怪 ， 但 实际 上 是 非常 有 用 的 。 例 如 ， 考 虑 以 下 结构 : 

struct CustomerName 

{ 


public string firstName, lastName; 


} 

如 果 变 量 关 型 是 CustomerName， 并 且 要 在 控制 侣 上 输出 一 个 完整 的 姓名 ， 融 必须 使 用 姓 、 名 构成 该 姓名 。 
例如 ， 对 于 CustomerName 变量 myCustomer， 可 以 使 用 下 述 语法 : 

CustomerName myCustomer; 

myCustomer.firstName = "John"; 


myCustomer.lastName = "Franklin"; 
WriteLine ($"{myCustomer.firstName} {myCustomer.lastName}"); 


把 函数 添加 到 结构 中 ， 就 可 以 集中 处 理 常 见 任 务 ， 从 而 简化 这 个 过 程 。 可 以 把 合适 的 函数 添加 到 结构 类 型 


struct CustomerName 
{ 

public string firstName, lastName; 

public string Name() => firstName + " " + lastName; 
] 


这 看 起 来 这 与 本 章 前 面 的 其 他 图 数 类 似 ， 只 不 过 没有 使 用 static IAM. AMAA BILD], SUED 
该 关键 字 不 是 结构 函数 所 需 的 即 可 。 这 个 函数 的 用 法 如 下 所 示 : 

CustomerName myCustomer; 

myCustomer.firstName = "John"; 


myCustomer.lastName = "Franklin"; 
WriteLine (myCustomer.Name()); 


ix^ rii iX LCT AE Ef m. BERD. TE, Name0 AAO VLA Rev In] firstName 和 lastName 
结构 成 员 。 在 customerName 结构 中 ， 它 们 可 以 被 看 成 全 局 成 员 。 
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本 章 前 面 提 到 过 ， 在 调用 图 数 时 ， 必 须 匹 配 国 数 的 釜 名 。 这 表明 ， 需 要 有 不 同 的 国 数 来 操作 不 同类 型 的 变 
量 。 函 数 重 载 多 许 创 建 多 个 同名 图 数 ， 每 个 图 数 可 使 用 不 同 的 参数 类 型 。 例 如 ， 前 面 使 用 了 下 述 代码 ， 其 中 包 


11 PBL Max Value(): 
class Program 
{ 
static int MaxValue(int[] intArray) 
{ 


int maxVal 
for (int i 
{ 
if (intArray[i] > maxVal) 
maxVal = intArray[il: 


intArray[0]; 
1; i « intArray.Length; i++) 


} 
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return maxVal; 
} 


static void Main(string[] args) 
{ 
int[] myArray = { 1, 8, 3, 6, 2, 5, 9, 3, 0, 2 }F 
int maxVal = MaxValue (myArray) ; 
WriteLine ("The maximum value in myArray is {maxVal}"); 
ReadKey () ; 
} 

} 

这 个 函数 只 能 用 于 处 理 int 数组 。 可 为 不 同 的 参数 类 型 提供 不 同名 称 的 函数 ， 例 如 把 上 述 函 数 重 命名 为 
IntArrayMaxValnue0， 并 添加 诸如 DoubleArrayMaxValue0O 的 图 数 来 处 理 其 他 类 型 。 还 有 一 种 方法 ,， 即 在 代码 中 添 
加 如 下 函数 : 

static double MaxValue(double[] doubleArray) 
{ 
double maxVal = doubleArray[0]; 
for (inti = 1; i < doubleArray.Length; i++) 


if (doubleArray[i] > maxVal) 
maxVal = doubleArray[il; 


return maxVal; 


} 

这 里 的 区 别 是 使 用 了 double 值 。 函 数 名 称 MaxValueO 是 相同 的 ， 但 其 签名 是 不 同 的 。 这 是 因为 如 前 所 述 ， 
函数 的 签名 包含 函数 的 名 称 及 其 参数 。 用 相同 签名 来 定义 两 个 函数 是 错误 的 ， 但 因为 这 里 的 两 个 函数 的 签名 不 
同 ， 所 以 没有 问题 。 


注意 : 
函数 的 返回 类 型 不 是 其 签名 的 一 部 分 ， 所 以 不 能 定义 两 个 仅 返 回 类 型 不 同 的 函数 ， 它 们 实际 上 有 相同 的 


添加 了 前 面 的 代码 后 ， 现 在 有 两 个 版 本 的 MaxValueO0， 它 们 的 参数 是 nt 和 double 数组 ， 分 别 返回 int 或 
double 类 型 的 最 大 值 。 

这 种 代码 的 优点 是 不 必 显 式 地 指定 要 使 用 哪个 函数 。 只 需要 提供 一 个 数组 参数 ， 就 可 以 根据 使 用 的 参数 类 
型 执行 相应 的 函数 。 

此 时 ， 应 注意 Visual Studio 中 IntelliSense 的 男 一 项 功能 。 如 果 在 应 用 程序 中 有 上 述 两 个 函数 ， 而 且 要 在 
Main0 或 其 他 函数 中 键入 函数 的 名 称 ，IDE 就 可 以 显示 出 可 用 的 重 载 图 数 。 如 果 键 入 下 面 的 代码 : 


double result = MaxValue( 


IDE heh MaxValueQhk AVE, EHE PRETERIRI, OA 6-11 所 示 。 


A 1of2 ¥ double Program.MaxValue(double[] doubleArray) | 


à 2of2 Y int Program.MaxValue(int[] intArray) 


图 6-11 
在 重 载 图 数 时 ， 应 包括 国 数 等 名 的 所 有 方面 。 例 如 ， 有 两 个 不 同 的 函数 ， 它 们 分 别 珊 有 值 参 数 和 引用 
参数 : 
static void ShowDouble(ref int val) 
{ 
static void ShowDouble(int val) 
{ 
} MG 
选用 哪个 版 本 完全 根据 函数 调用 是 否 包含 ref 关键 字 来 确定 。 下 面 的 代码 将 调用 引用 版 本 ; 


ShowDouble (ref val); 
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下 面 的 代码 将 调用 值 版 本 : 
ShowDouble (val); 


此 外 ， 还 可 以 根据 参数 的 个 数 等 来 区 分 函数 。 


6.6 zit 


委托 (delegate) 是 一 种 存储 函数 引用 的 类 型 。 这 听 起 来 相当 深奥 ， 但 其 机 制 是 非常 简单 的 。 委 托 最 重要 的 用 
途 在 本 书后 面 介绍 到 事件 和 事件 处 理 时 才能 解释 清楚 ， 但 这 里 也 将 介绍 有 关 委 托 的 许多 内 容 。 委 托 的 声明 非常 
类 似 于 函数 ， 但 不 市 函数 体 ， 且 要 使 用 delegate 关键 字 。 委 托 的 声明 指定 了 一 个 返回 类 型 和 一 个 参数 列表 。 

定义 了 委托 后 ， 束 可 以 声明 该 委托 关 型 的 变量 。 接 独 把 这 个 变量 初始 化 为 与 委托 具有 相同 返回 关 型 和 参数 
列表 的 图 数 引用 。 之 后 ， 就 可 以 使 用 委托 变量 调用 这 个 国 数 ， 融 像 该 变量 是 一 个 图 数 一 样 。 

有 了 引用 胃 数 的 变量 后 ， 残 可 以 执行 无 法 用 其 他 方式 完成 的 操作 。 例 如 ， 可 以 把 委托 变量 作为 参数 传递 给 
一 个 图 数 ， 这 样 ， 该 函数 束 可 以 使 用 委托 调用 它 引 用 的 任何 图 数 ， 而 且 在 运行 之 前 不 必 知 道 调 用 的 是 哪个 图 数 。 
下 面 的 示例 使 用 委托 访问 两 个 函数 中 的 一 个 。 


试 一 试 ” 使 用 委托 来 调用 函数 : Ch06Ex05\Program.cs 


(1) f£ C:\BeginningCSharp7\Chapter06 目录 中 创建 一 个 新 的 控制 台 应 用 程序 ChO6Ex05 . 
(2) 把 下 列 代 码 添加 到 Program.cs "P: 


class Program 

{ 
delegate double ProcessDelegate (double paraml, double param?) ; 
static double Multiply (double parami, double param?) => parami * param2; 
static double Divide(double paraml, double param2) => paraml / param2; 


Static void Main(string[] args) 
{ 
ProcessDelegate process; 
WriteLine ("Enter 2 numbers separated with a comma:"); 
string input = ReadLine(); 
int commaPos = input.IndexOf(','); 
double paramı = ToDouble(input.Substring(0, commaPos)); 
double param? = ToDouble(input.Substring(commaPos + 1, 
input.Length - commaPos - 1)); 
WriteLine("Enter M to multiply or D to divide:"); 
input = ReadLine(); 
if (input == "M") 
process = new ProcessDelegate (Multiply): 
else 
process = new ProcessDelegate (Divide); 
WriteLine($"Result: {process (paraml, param2))"); 
ReadkKey () ; 
} 
} 


(3) 执行 代码 ， 在 看 到 提示 时 输入 值 ， 结 果 如 图 6-12 所 示 。 


图 6-12 


示例 说 明 
这 段 代 码 定义 了 一 个 委托 ProcessDelegate， 其 返回 类 型 和 参数 与 函数 Multiply0 和 Divide0 相 匹配 。 注 意 
Multiply0 和 Divide0 方 法 使 用 了 =>(Lambda 8j 3/235 353 IA). 


98 | 第 | 部 分 C# 语言 


static double Multiply(double paraml, double param2) => paraml * param2; 
委托 的 定义 如 下 所 示 : 
delegate double ProcessDelegate (double paraml, double param2); 
delegate 关键 字 指 定 该 定义 是 用 于 委托 的 ， 而 不 是 用 于 函数 的 (该 定义 所 在 的 位 置 与 函数 定义 相同 )。 接 看 ， 
该 定义 指定 double 返回 类 型 和 两 个 double FAL. 实际 使 用 的 名 称 可 以 是 任意 的 , 所 以 可 以 给 委托 类 型 和 参数 指 
定 任 意 名 称 。 这 里 委托 名 是 ProcessDelegate，double 参数 名 是 param] 和 param2。 
Main0 中 的 代码 首先 使 用 新 的 委托 类 型 声明 一 个 变量 : 
static void Main(string[] args) 


{ 


ProcessDelegate process; 
接着 用 一 些 比较 标准 的 C# 代 码 请 求 由 逗号 分 隔 的 两 个 数字 ， 并 将 这 些 数字 放 在 两 个 double 变量 中 : 
WriteLine ("Enter 2 numbers separated with a comma:"); 
string input = ReadLine(); 
int commaPos = input.Indexof(','); 


double paraml = ToDouble(input.Substring(0, commaPos)); 
double param2 = ToDouble(input.Substring(commaPos + 1, 


input.Length - commaPos - 1)); 


注意 : 
为 说 明 问 题 ， 这 里 没有 验证 用 户 输 入 的 有 效 性 。 如 果 这 些 是 “现实 中 的 ”代码 ， 就 应 花费 更 多 时 间 来 确保 
在 局 部 变量 paraml 和 param2 中 得 到 有 效 的 值 。 


接 痢 询问 用 户 ， 这 两 个 数字 是 要 相 乘 还 是 相 除 : 


WriteLine ("Enter M to multiply or D to divide:"); 
input = ReadLine(); 


根据 用 户 的 选择 ， 初 始 化 process 委托 变量 : 


if (input == "M") 
process = new ProcessDelegate (Multiply); 
else 


process = new ProcessDelegate (Divide); 

要 把 一 个 函数 引用 赋 给 委托 变量 ， 需 要 使 用 略 显 古怪 的 语法 。 这 个 过 程 比 较 类 似 于 给 数组 赋值 ， 必 须 使 用 
new 关键 字 创 建 一 个 新 委托 。 在 这 个 关键 字 的 后 面 ， 指 定 委托 类 型 ， 提 供 一 个 引用 所 需 国 数 的 参数 ， 这 里 也 束 
是 指 Multiply0 或 Divide0 困 数 。 注 意 这 个 参数 与 委托 类 型 或 目标 函数 的 参数 不 匹配 ， 这 十 委托 赋值 的 一 种 独特 
语法 ， 参 数 是 要 使 用 的 函数 名 且 不 带 插 号 。 

实际 上 ， 这 里 可 以 使 用 略微 简单 的 语法 : 

if (input == "M") 
process = Multiply; 
p oc = Divide; 

编译 器 会 友 现 ，process 变量 的 委托 关 型 匹配 两 个 国 数 的 釜 名 ， 于 是 目 动 初始 化 一 个 委托 。 可 以 目 行 确定 使 
用 哪 种 语法 ， 但 一 些 人 如 欢 使 用 较 长 的 版 本 ， 因 为 它 更 容易 一 眼看 出 会 友 生 什么 。 

最 后 ， 使 用 该 委托 调用 所 选 的 函数 。 无 论 委托 引用 的 是 什么 函数 ， 该 语法 部 是 有 效 的 : 

WriteLine ($"Result: {process(paraml, param2)}"); 
: ReadKey () ; 

xx HUZSFESERUR X TAAA. (HER IUIS I SD, RIDE ee Seay BSE, Bla, i834 

将 其 传递 给 一 个 函数 ， 如 下 例 所 示 : 


static void ExecuteFunction (ProcessDelegate process) 
=> process(2.2, 3.3); 


PLRIAPE—T BEAN "E" PR, SEERA eG Te ST A, BAY LAP eR AAT. Blo, — 
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函数 要 对 字符 串 数组 按照 字母 进行 排序 。 对 列表 排序 有 几 种 不 同 的 方法 , 它们 的 性 能 取决 于 要 排序 的 列表 特性 。 
使 用 委托 可 以 把 一 个 排序 复 法 函数 委托 传递 给 排序 图 数 ， 指 定 要 使 用 的 函数 。 
委托 有 许多 用 途 ， 但 如 前 所 述 ， 它 们 的 大 多 数 第 见 用 途 主 要 与 事件 处 理 有 关 ， 具 体内 容 评 见 第 13 38. 


6.7 ”习题 


(1) 下 面 两 个 国 数 都 存在 错误 ， 请 指出 这 些 错误 。 


static bool Write () 
{ 


WriteLine ("Text output from function."); 


} 
static void MyFunction (string label, params int[] args, bool showLabel) 
{ 
if (showLabel) 
WriteLine (label); 
foreach (int 1 in args) 
WriteLine (S"{i}"); 
} 


(2) 编写 一 个 应 用 程序 ， 该 程序 使 用 两 个 命令 行 参数 ， 分 别 把 值 放 在 一 个 字符 串 和 一 个 整 型 变量 中 ， 然 后 
显示 这 些 值 。 

(3) 创建 一 个 委托 ， 在 请 求 用 尸 输入 时 ， 使 用 它 模 拟 ReadLine0 函 数 。 

(4) 修改 下 面 的 结构 ， 使 其 包含 一 个 返回 订单 总 价 的 函数 。 


struct order 

{ 
public string itemName; 
public int unitCount; 
public double unitCost; 

} 


(5) 在 order 结构 中 添加 另 一 个 图 数 ， 使 其 返回 如 下 所 示 的 一 个 格式 化 字符 串 ( 一 行文 本 ， 以 合适 的 值 昔 换 
FASTA S TRE IN RA A). 


Order Information: «unit count» «item name> items at S«unit cost» each, 
total cost S«total cost> 


附录 A 给 出 了 习题 答案 。 
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tom 要 m 
用 函数 名 、0 个 或 多 个 参数 及 返回 类 型 来 定义 函数 。 函 数 的 名 称 和 参数 统称 为 函数 的 签名 。 可 以 定义 名 称 


— TR IRMB AS 44 ANI] e p $1 PN. t RT AE PE PBL 
PRAY [BITE EEEREN, WRB A RE, JORIBIZEUNUS void。 参 数 也 可 以 是 任意 类 型 ， 

返回 信和 有 参数 THE SAR AR SRO. TNE ERE NS SLE SOE. P 
EJ ref 或 out， 以 便 给 调用 者 返回 值 。 调 用 函数 时 ， 所 指定 的 参数 的 类 型 和 顺序 必须 匹配 函数 的 定义 ， 并 
且 如 果 参 数 定义 中 使 用 了 ref 或 out 关键 字 ， 那 么 在 调用 函数 时 也 必须 包括 对 应 的 ref 或 out 关键 字 

———— RU 
用 域 中 定义 多 个 不 同 的 同名 变量 

命令 行 参数 在 执行 应 用 程序 时 ， 控 制 台 应 用 程序 中 的 Main0 函 数 可 接收 传送 给 应 用 程序 的 命令 行 参数 。 这 些 参数 用 空 
格 阳 开 ， 较 长 的 参数 可 以 放 在 引号 中 传送 

委托 除了 直接 调用 函数 外 ， 还 可 以 通过 委托 调用 它们 。 委 托 是 用 返回 类 型 和 参数 列表 定义 的 变量 。 给 定 的 委托 


类 型 可 以 匹配 返回 类 型 和 参数 与 委托 定义 相同 的 方法 


第 
调试 和 钼 误 处 理 


REA: 
e IDE 中 的 调试 方法 
@ 《CC# 中 的 错误 处 理 技术 


本 章 源 代码 可 以 通过 本 书 合 作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter07 文件 夹 中 并 已 根据 本 章 示例 的 名 称 
单独 命名 。 


本 书 到 目前 为 止 介绍 了 在 C# 中 进行 简单 编程 的 所 有 基础 知识 。 本 书 下 一 部 分 将 讨论 面 问 对 象 编程 , 在 此 之 
前 先 看 看 C# 代 人 码 中 的 调试 和 错误 处 理 。 

代码 中 有 时 难免 存在 错误 。 无 论 程序 员 多 么 优秀 ， 程 序 总 是 会 出 现 一 些 问题 ， 优 秀 的 程序 员 必 须 童 识 到 这 
一 后 ， 并 准备 好 解决 这 些 问 题 。 当 然 ， 一些 问 题 比 较 小 ， 不 会 影 啊 应 用 程序 的 执行 ， 例 如 ， 按 钮 上 的 拼写 错误 
等 ， 但 一 些 错 误 可 能 比较 严重 ， 会 导致 应 用 程序 完全 失败 (通常 称 为 致命 错误 )， 致 命 错误 包括 妨碍 代码 编 详 的 
简单 错误 (语法 错误 )， 或 者 只 在 运行 期 间 发 生 的 更 严重 错误 。 一 些 错误 较 难 注意 到 。 例 如 ， 也 许 因 为 缺少 请 求 
的 字段 ， 应 用 程序 不 能 给 数据 库 添 加 一 条 记录 ， 或 者 在 其 他 有 限制 的 环境 中 把 错误 数据 添加 到 记录 中 。 应 用 程 
序 的 多 辑 在 霖 些 方面 有 瑕 站 时 ， 束 会 产生 这 样 的 错误 ， 此 类 错误 称 为 语义 错误 (或 逻辑 错误 )。 

通 弟 ， 当 应 用 程序 的 用 户 抱 怨 程 序 不 能 正 营 工作 时 ， 开 发 人 员 才 会 知道 存在 这 样 的 错误 。 此 时 需要 跟踪 代 
码 ， 确 定 发 生 了 什么 问题 ， 并 修改 代码 ， 使 其 按照 布 望 的 那样 工作 。 此 类 情况 下 ，Visual Studio 的 调试 功能 就 
可 以 大 显 映 手 了 。 本 章 的 第 一 部 分 束 介 绍 一 些 调试 技巧 ， 并 用 它们 来 解决 一 些 常 见 问题 。 

此 后 讨论 C# 中 的 错误 处 理 技术 。 利 用 它们 ， 可 以 对 可 能 友 生 错误 的 地 方 采 取 预 防 措施 ， 并 编写 弹性 代码 来 
处 理 可 能 致命 的 错误 。 这 些 技术 是 C# 语 言 的 一 部 分 ， 而 不 是 调试 功能 ， 但 IDE 也 提供 了 一 些 工具 来 帮助 我 们 
处 理 错 误 。 


7.1 Visual Studio 中 的 调试 


前 面 提 到 ， 可 以 采用 两 种 方式 执行 应 用 程序 : 调试 模式 或 非 调试 模式 。 在 Visual Studio 中 执行 应 用 程序 时 ， 
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默认 在 调试 模式 下 执行 。 例 如 ， 按 下 FS 键 或 单 击 工具 栏 中 的 绿色 Start 按钮 时 ， 就 是 在 调试 模式 下 执行 应 用 程 
序 。 要 在 非 调试 模式 下 执行 应 用 程序 ， 应 选择 Debug | Start Without Debugging， 或 按 下 Ctrl+F5 组 合 键 。 

Visual Studio 允许 在 两 种 配置 下 生成 应 用 程序 : 调试 (默认 ) 和 发 布 。 使 用 标准 工具 栏 中 的 Solution Configurations 
下 拉 框 可 在 这 两 种 配置 之 间 切 换 。 

在 调试 配置 下 生成 应 用 程序 ， 并 在 调试 模式 下 运行 程序 时 ， 并 不 仅 是 运行 编写 好 的 代码 。 调 试 程 序 包 含 应 
用 程序 的 符号 信息 ， 所 以 IDE 知道 执行 每 行 代码 时 发 生 了 什么 。 符 号 信息 意味 着 跟踪 (例如 ) 未 编译 代码 中 使 用 
的 变量 名 ， 这 样 它们 就 可 以 匹配 已 编译 的 机 器 人 码 应 用 程序 中 现 有 的 值 ， 而 机 器 人 码 程序 不 包含 便于 人 们 阅读 的 信 
息 。 此 类 信息 包含 在 .pdb 文件 中 ， 这 些 文件 位 于 计算 机 的 Debug 目录 下 。 

发 布 配置 会 优化 应 用 程序 代码 ， 所 以 我 们 不 能 执行 以 上 这 些 操作 。 但 发 布 版 本 运行 速度 较 快 。 完 成 了 应 用 
程序 的 开发 后 ， 一 般 应 给 用 户 提 供 发 布 厂 本 ， 因 为 上 友 布 版 本 不 需要 调试 版 本 所 包含 的 符号 信息 。 

本 节 介 绍 调试 技巧 ， 以 及 如 何 使 用 它们 找 出 并 修改 未 按 预 期 方式 执行 的 那些 代码 ， 这 个 过 程 称 为 调试 。 按 
照 这 些 技术 的 使 用 方法 把 它们 分 为 两 部 分 。 一 般 情 况 下 ， 可 以 先 中 断 程 序 的 执行 ， 再 进行 调试 ， 或 者 注 上 标记 ， 
以 便 以 后 加 以 分 析 。 在 Visual Studio 术语 中 ， 应 用 程序 可 以 处 于 运行 状态 ， 也 可 以 处 于 中 断 模 式 ， 即 暂停 正常 
的 执行 。 下 面 育 先 介绍 非 中 断 模 式 (运行 期 间或 正 妆 执行) 技术 。 


7.1.1 非 中 断 ( 正 常 ) 模 式 下 的 调试 


本 书 经 党 使 用 的 一 个 命令 是 WriteLine0 国 数 ， 它 可 以 把 文本 箱 出 到 控制 台 。 在 开 友 应 用 程序 时 ， 这 个 图 数 
可 以 方便 地 获得 操作 的 额外 反 饿 ， 例 如 : 
WriteLine ("MyFunc() Function is about to be called."); 


MyFunc ("Do something."); 
WriteLine ("MyFunc() Function execution completed."); 


这 段 代 码 说 明了 如 何 获取 MyFunc0 函 数 的 额外 信息 。 这 么 做 完全 正确 ， 但 控制 台 的 输出 结果 会 比较 混乱 。 
在 开发 其 他 类 型 的 应 用 程序 时 ， 如 果 面 应 用 程序 ， 没 有 用 于 输出 信息 的 控制 台 。 作 为 一 种 蔡 代 方 法 ， 可 将 文本 
输出 到 另 一 个 位 置 一 一 IDE 中 的 Output 窗口 。 

第 2 章 简要 介绍 了 Enor List 窗口 ， 其 中 提 到 其 他 窗口 也 可 以 显示 在 这 个 位 


。 其 中 一 个 窗口 就 是 Output 窗口 ， 


在 调试 时 这 个 窗口 非常 有 用 。 要 显示 这 个 窗口 ， 可 以 选择 View | Output。 在 这 个 窗口 中 ， 可 以 得 看 与 代码 的 编 
译 和 执行 相关 的 信息 ， 包 括 在 编译 过 程 中 遇 到 的 错误 等 ， 还 可 将 自 定 义 的 诊断 信息 直接 写 到 这 个 窗口 中 ， 该 窗 
口 如 图 7-1 所 示 。 


Show output from: Debug | | | ‘`b 


Build 
Build Order 
Debug 


注意 : 
使 用 Output 窗口 的 下 拉 菜 单 可 以 选择 几 种 模式 : Build. Build Order 和 Debug。 这 些 模 式 分 别 显 示 编 译 和 运 
行 期 间 的 信息 。 本 节 提 到 “ 写 入 Output 窗口 ”时 ， 实 际 上 是 指 “ 写 入 Output 窗口 的 Debug BAMA” . 


男 外 ， 还 可 以 创建 一 个 日 志文 件 ， 在 运行 应 用 程序 时 ， 会 把 信息 添加 到 该 日 志文 件 中 。 把 信息 写 入 日 志文 
件 所 用 的 技巧 与 把 文本 写 到 Output 窗口 中 所 用 的 技巧 相同 ， 但 需要 理解 如 何 从 C# 应 用 程序 中 访问 文件 系统 。 
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我 们 把 这 个 功能 放 在 后 面 的 章节 中 加 以 讨论 ， 因 为 目前 不 必 了 解 文件 访问 技巧 也 可 以 完成 很 多 工作 。 

1. 输出 调试 信息 

在 运行 期 间 把 文本 写 入 Output 窗口 是 非 营 简单 的 。 只 要 用 所 需 的 调用 蔡 代 WiriteLine0 调 用 ， 束 可 以 把 文本 
写 到 所 希望 的 位 置 。 此 时 可 以 使 用 如 下 两 个 命令 : 

e Debug.WriteLine() 

e Trace.WriteLine() 

这 两 个 命令 函数 的 用 法 几乎 完全 相同 ， 但 有 一 个 重要 区 别 : 第 一 个 命令 仅 在 调试 模式 下 运行 ， 而 第 二 个 命 
令 还 可 用 于 发 布 程序 。 实 际 上 ，Debug.WriteLineO 命 令 甚至 不 能 编译 到 可 发 布 的 程序 中 ， 在 发 布 版 本 中 ， 该 命 
令 会 消失 ， 这 肯定 有 其 优点 (编译 好 的 代码 文件 比较 小 )。 

注意 : 

Debug.WriteLine0 和 Trace.WriteLine( 方 法 包含 在 System.Diagnostics 名 称 空间 内 。using static 指令 只 能 用 于 
静态 类 ,例如 包括 WriteLine0) 方 法 的 System.Console, 因此 该 指令 不 能 用 在 Debug.WriteLine0 和 Trace. WriteLine() 
函数 中 。 

这 两 个 函数 的 用 法 与 WriteLine0 是 不 同 的 。 其 唯一 的 字符 串 参 数 用 于 输出 消 足 ， 而 不 需要 使 用 { 仅 } 语 法 插 
入 变量 值 。 这 意味 痢 必 须 使 用 + 串联 运 复 符 等 方式 在 字符 串 中 搬入 变量 值 。 它 们 还 可 以 有 第 二 个 字符 串 参 数 (可 
选 ), 用 于 显示 得 出 文本 的 类 别 。 这样, 如 果 应 用 程序 的 不 同 地 方 输出 了 类 似 的 消 明 , 我 们 马上 就 可 以 确定 Output 
窗口 中 显示 的 是 哪些 输出 信息 。 

这 些 函 数 的 一 般 输 出 如 下 所 示 : 

<category>: <message> 

例如 ， 下 面 的 语句 把 “MyFunc” 作 为 可 选 的 类 别 参数 : 

Debug.WriteLine ("Added 1 to i", "MyFunc"); 

其 结果 为 : 


MyFunc: Added 1 to i 


下 面 的 示例 按 这 种 方式 输出 调试 信息 。 


试 一 试 ” 把 文本 写 入 Output BHO: Ch07Ex01\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter07 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch07Ex01。 
(2) 修改 代码 ， 如 下 所 示 : 


using System; 
using System.Collections.Generic; 
using System.Ling; 
using System.Text; 
using System. Threading.Tasks; 
using System.Diagnostics; 
using static System.Console; 
namespace Ch07Ex01 
{ 
class Program 
{ 
static void Main(string[] args) 


{ 


int[] testArray = (4,7, 4, 2, 7, 3, 7, 8, 3, 9, 1, 9}; 
int maxVal = Maxima(testArray, out int[] maxValIndices) ; 
WriteLine ($"Maximum value {maxVal} found at element indices:"); 
foreach (int index in maxValIndices) 
{ 

WriteLine (index) ; 
} 
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ReadKey () ; 
} 
static int Maxima(int[] integers, out int[] indices) 
{ 
Debug .WriteLine ("Maximum value search started."); 
indices = new int[1]; 
int maxVal = integers[0]; 
indices[0] = 0; 
int count = 1; 
Debug .WriteLine (string. Format ( 
$"Maximum value initialized to {maxVal}, at element index 0.")); 
for (int i = 1; i < integers.Length; i++) 
{ 
Debug .WriteLine (string. Format ( 
$"Now looking at element at index {i}.")); 
if (integers[i] > maxVal) 
{ 
maxVal = integers[i]; 
count = 1; 
indices = new int[1]; 
indices[0] = i; 
Debug .WriteLine (string. Format ( 
$"New maximum found. New value is {maxVal}, at " + 
S"element index {i}.")); 
} 
else 
{ 
if (integers[i] == maxVal) 
{ 
count++; 
int[] oldIndices = indices; 
indices = new int[count] ; 
oldIndices.CopyTo(indices, 0); 
indices [count - 1] = i; 
Debug .WriteLine (string. Format ( 
$"Duplicate maximum found at element index {i}.")); 
} 
} 
} 
Trace .WriteLine (string. Format ( 
$"Maximum value {maxVal} found, with {count} occurrences.")); 
Debug.WriteLine("Maximum value search completed."); 
return maxVal; 
) 


} 
(3) 在 Debug 模式 下 执行 代码 ， 结 果 如 图 7-2 所 示 。 


图 7-2 


(4) 中 断 应 用 程序 的 执行 ， 碍 看 Output 窗口 中 的 内 容 ( 在 Debug 模式 下 )， 如 下 所 示 ( 有 删 减 ): 


Maximum value search started. 

Maximum value initialized to 4, at element index 0. 

Now looking at element at index 1. 

New maximum found. New value is 7, at element index 1. 

Now looking at element at index 

Now looking at element at index 

Now looking at element at index 

Duplicate maximum found at element index 4. 

Now looking at element at index 5. 

Now looking at element at index 6. 

Duplicate maximum found at element index 6. 

Now looking at element at index 7. 

New maximum found. New value is 8, at element index 7. 

Now looking at element at index 8. 

Now looking at element at index 9. 
9, 


WW ho =J 


New maximum found. New value is at element index 9. 


第 7 章 RMR | 105 


Now looking at element at index 10. 

Now looking at element at index 11. 

Duplicate maximum found at element index 11. 
Maximum value 9 found, with 2 occurrences. 
Maximum value search completed. 

The thread #t### has exited with code 0 (0x0). 


(5) 使 用 标准 工具 栏 上 的 下 拉 采 单 ， 切 换 到 Release 模式 ， 如 图 7-3 所 示 。 [Debus B 
(S) 再 次 运行 程序 ， 这 次 在 Release 模式 下 运行 ， 并 在 执行 终止 时 再 查看 一 下 oen 
Output 窗 HL, 结果 如 下 所 示 ( 有 删 减 ): Configuration Manager... 


7-3 


Maximum value 9 found, with 2 occurrences. 
The thread #### has exited with code 0 (0x0). 


示例 说 明 

这 个 应 用 程序 是 第 6 革 中 一 个 示例 的 扩展 版 本 ， 它 使 用 一 个 函数 计算 整数 数组 中 的 最 大 值 。 这 个 版 本 也 返 
回 一 个 索引 数组 ， 表 示 最 大 值 在 数组 中 的 位 置 ， 以 便 调用 代码 处 理 这 些 元 素 。 

自 先 在 代码 开头 使 用 了 一 个 额外 的 using 指令 : 


using System.Diagnostics; 


这 简化 了 前 面 讨论 的 对 函数 的 访问 , 因为 它们 包含 在 System.Diagnostics 名 称 空 间 中 , 没有 这 个 using 语句， 
下 面 的 代码 : 

Debug .WriteLine ("BeginningC#"); 

就 需要 进一步 限定 ， 重 新 编写 这 行 语句 ， 如 下 所 示 : 

System. Diagnostics.Debug.WriteLine ("BeginningC#"); 


Main0 中 的 代码 仅 初 始 化 一 个 测试 用 的 整数 数组 testArray， 并 声明 了 男 一 个 整数 数组 maxValindices, 
以 存储 Maxima0( 执 行 计算 的 图 数 ) 的 索引 输出 结果 ， 接 看 调用 这 个 国 数 。 图 数 返 回 后 ， 代 码 就 会 答 出 结果 。 

Maxima() 稍 复杂 一 些 ， 但 用 到 的 代码 大 部 分 在 前 和 面 已 经 看 到 过 。 在 数组 中 进行 搜索 的 方式 与 第 6 章 的 
MaxValO 国 数 类 似 ， 但 要 用 一 条 记录 来 存储 最 大 值 的 索引 。 

特别 需要 注意 用 来 跟 踊 索引 的 尔 数 (而 不 古 输出 调试 信息 的 那些 代码 行 )。Maxima0 并 没有 返回 一 个 足以 存 
储 源 数组 中 每 个 过 引 的 数组 (需要 与 源 数 组 有 相同 的 维 数 )， 而 是 返回 一 个 正好 能 容纳 搜索 到 的 索引 的 数组 。 这 
可 通过 在 搜索 过 程 中 连续 重建 不 同 长 度 的 数组 来 实现 。 必 须 这 么 做 ， 因 为 一 旦 创建 好 数组 ， 就 不 能 再 重新 设置 
长 度 。 

开始 搜索 时 ， 假 定 源 数组 (ntegers) 中 的 第 一 个 元 素 就 是 最 大 值 ， 而 且 数 组 中 只 有 一 个 最 大 值 。 因 此 可 以 
为 maxVal( 函 数 的 返回 值 ， 即 搜索 到 的 最 大 值 ) 和 indices(out 参数 数组 ， 存 储 搜 索 到 的 最 大 值 的 索引 ) 设 置 值 。 
max Val 被 赋予 integers 中 第 一 个 元 素 的 值 , indices 被 赋予 一 个 0 值 , 即 数 组 中 弟 一 个 元 系 的 索引 。 在 变量 count 
中 存储 搜索 到 的 最 大 值 的 个 数 ， 以 便 跟 踊 indices 数组 。 

RAEE ANIA, EIEN integers 数组 中 的 各 个 值 ， 但 忽略 第 一 个 值 ， 因 为 它 已 经 处 理 过 这 个 值 。 
每 个 值 都 与 maxVal 的 当前 值 进行 比较 ， 如 果 maxVal 更 大 ， 就 忽略 该 值 。 如 果 当 前 处 理 的 值 比 maxVal 大 ， 就 
修改 maxVal 和 indices， 以 反映 这 种 情况 。 如 果 当 前 处 理 的 值 与 maxVal 相等 ， 就 递增 count， 用 一 个 新 数组 蔡 代 
indices。 这 个 新 数组 比 旧 indices 数组 多 一 个 元 素 ， 它 包含 搜索 到 的 新 索引 。 

最 后 一 个 功能 的 代码 如 下 所 示 : 

if (integers[i] == maxVal) 
count++; | 
int[] oldIndices - indices; 
indices = new int[count]; 
oldIndices.CopyTo (indices, 0); 
indices[count - 1] = 1; 


Debug.WriteLine (string.Format ( 
sS"Duplicate maximum found at element index {1}.")); 
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这 段 代 码 把 旧 indices 数组 备份 到 站 代码 块 的 oldIndices 局 部 整 型 数组 中 。 注 意 使 用 <array>. Copy ToOFf 
PGE oldIndices 中 的 值 复制 到 新 的 indices 数组 中 。 这 个 函数 的 参数 是 一 个 目标 数组 和 一 个 用 于 复制 第 一 个 元 条 
的 索引 ， 并 把 所 有 的 值 都 粘贴 到 目标 数组 中 。 

在 代码 中 ， 各 个 文本 部 分 都 使 用 Debug.WriteLine0 和 Trace.WriteLineO 国 数 进 行 输出 ， 这 些 函 数 使 用 
string.FormatO 国 数 把 变量 值 人 通 和 套 在 字符 串 中 ， 其 方式 与 WriteLine0 相 同 。 这 上 比 使 用 + 串联 运 复 符 更 局 效 。 

在 Debug 模式 下 运行 应 用 程序 时 , 其 最 终结 果 是 一 条 完整 记录 , 它 记 述 了 在 循环 中 计算 出 结果 所 采取 的 步骤 。 
在 Release 模式 下 ， 仅 能 看 到 计算 的 最 终结 果 ， 因 为 没有 调用 Debug WriteLineQ FUR. 

2. 跟踪 点 

另 一 种 把 信息 输出 到 Output 窗口 的 方法 是 使 用 跟踪 点 (tracepoint)。 这 是 Visual Studio 的 一 个 功能 ， 而 不 是 
C# 的 功能 ， 但 其 作用 与 使 用 Debug.WiriteLine0 相 同 。 它 实际 上 是 输出 调试 信息 且 不 修改 代码 的 一 种 方式 。 

为 了 演示 跟踪 点 , 可 用 它们 蔡 代 上 一 个 示例 中 的 调试 命令 (请 参阅 本 章 的 下 载 代码 中 的 Ch07Ex01TracePoints 
文件 )。 添 加 跟 踊 点 的 过 程 如 下 : 

(1) 把 光标 放 在 要 插入 跟踪 点 的 代码 行 (例如 ，Line 31) 上 。 跟 踪 点 会 在 执行 这 行 代 码 之 前 被 处 理 。 

(2) 单 击 行 号 左边 的 侧 边 栏 ， 会 出 现 一 个 红色 的 圆 。 将 鼠标 指针 悬 停 在 这 个 红色 的 圆 上 上， 选择 Settings X 
单项 。 

(3) 选中 Actions 复 选 框 ， 在 Log a message 部 分 的 Message 文本 框 中 刍 
量 值 ， 应 把 变量 名 放 在 花 括 号 中 。 

(4) 单 击 OK 按钮 。 在 包含 跟踪 点 的 代码 行 左 边 的 红色 加 会 变 成 一 个 红色 委 形 ， 该 行 突出 显示 的 代码 也 会 
由 红色 变 为 日 色 。 


入 要 输出 的 字符 串 。 如 果 要 输出 变 


看 一 下 添加 跟踪 点 的 对 话 框 标题 和 需要 的 沫 单 选项 ， 显然， 跟 踊 点 是 断 点 的 一 种 形式 (可 以 暂停 应 用 程序 的 
执行 ， 束 像 断 点 一 样 )。 断 点 一 般 用 于 更 蜗 级 的 调试 目的 ， 本 半 稍 后 将 介绍 断后 。 


图 7-4 显示 了 ChO7Ex01TracePoints 中 第 31 行 所 需 的 跟 踊 点 。 在 删除 已 有 的 Debug.WriteLineO 语 句 后， 对 
代码 行 编号 。 


Breakpoint Settings X 


Location: Program.cs, Line: 31, Character: 18, Must match source 


Actions 


Log a message to Output Window: Maximum value initialized to {(maxVal}, at element index 0 X Saved 


[v Continue execution 


图 7-4 


还 有 一 个 窗口 可 用 于 快速 查看 应 用 程序 中 的 跟踪 点 。 要 显示 这 个 窗口 ， 可 从 Visual Studio 菜单 中 选择 Debug | 
Windows | Breakpoints。 这 是 显示 断 点 的 通用 窗口 (如 前 所 述 ， 跟 踪 点 是 断 点 的 一 种 形式 )。 可 以 定制 显示 的 内 容 ， 
从 这 个 窗口 的 Columns 下 拉 框 中 添加 When Hit 列 ， 显 示 与 跟踪 点 关系 更 密切 的 信息 。 图 7-5 显示 的 窗口 配置 了 
该 列 ， 还 显示 了 了 添加 到 Ch07Ex01TracePoints 中 的 所 有 跟 踩 点 。 


Program.cs 上 X 
ChO7Ex01TracePoints 


{ 
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- |. ^& ChO7Ex01TracePoints.Program - | Dm Main(string[] args) 


static int Maxima(int[] integers, out int[] indices) 


- new int[1]; 


z s a 
int maxVal = integers[@]; 
indices[@] = @; 
int count = 1; 
for (int i = 1; i < integers.Length; i++) 


{ 


breakpoints 

Newsy X $e CG F 
Name 

mL 2 Program.cs, line 27 character 13 
~[¥)@ Program.cs, line 31 character 18 
~[¥]@ Program.cs, line 33 character 17 
| [714 Program.cs, line 39 character 17 
| [¥]@ Program.cs, line 49 character 21 
| {“]@ Program.cs, line 54 character 13 


if (integers[i] > maxVal) 


maxVal = integers[i]; 


count = 1; 


indices = new int[1]; 


indices[8] = i; 


if (integers[i] 


{ 


Columns * Search: 


Labels Condition 


count++; 


== maxVal) 


int[] oldIndices = indices; 
indices = new int[count]; 


oldIndices.CopyTo(indices, 8); 


indices[count - 1] - i; 


(no condition) 
(no condition) 
(no condition) 
(no condition) 
(no condition) 
(no condition) 


Hit Count 


break always 
break always 
break always 
break always 
break always 
break always 


A 


n 
£u 


- |n Column: | All visible -| 2 


When Hit 

Print message ‘Maximum value search started.’ 

Print message ‘Maximum value initialized to (maxVal], at element index 0’ 

Print message ‘Now looking at element at index {iF 

Print message ‘New maximum found. New value is {maxVal}, at element index {i} | 
Print message ‘Duplicate maximum found at element index {i} 

Break 


7-5 


TE Va EX PaVTIXCT NH. Z5 $5 aM Tee IAIN. EAB A LI PUER HERE we AH 
Breakpoints 窗口 ， 可 以 删除 或 临时 茶 用 跟 躁 点 。 在 Breakpoints AOP, PRERA ZA AH E 0G HE Ta AN ze 79 Ja HER 
踩点 ; SHINER ABE, FETU BE LI TB LN AICHE, MAE DT 


3. 诊断 输出 与 跟 踊 点 


前 和 面 介绍 了 两 种 输出 相同 信息 的 方法 ， 下 面 分 析 它 们 的 优 缺 上 后。 首先 ， 跟 踊 扣 与 Trace 命令 并 不 等 价 ， 也 
束 古 说 ， 不 能 使 用 跟 踩点 在 及 布 版 本 中 输出 信息 。 这 是 因为 跟 踊 后 并 没有 包含 在 应 用 程序 中 。 跟 踩点 由 Visual 
Studio 处 理 ， 在 应 用 程序 的 已 编 诺 版 本 中 ， 跟 踩点 是 不 存在 的 。 只 有 应 用 程序 在 Visual Studio 调试 磊 中 运行 时 ， 


跟 蹊 点 才 起 作用 。 


跟 踩 点 的 主要 缺点 也 是 其 主要 优点 ， 即 它们 存储 在 Visual Studio 中 ， 因 此 可 以 在 需要 时 便捷 地 添加 到 应 用 
程序 中 ， 而 且 也 非 第 容易 删除 。 如 果 输 出 非常 复杂 的 字符 串 信息 ， 筑 得 跟 踊 扣 非 第 令 人 讨厌 ， 只 需要 单 击 表示 
其 位 置 的 红色 委 形 ， 束 可 以 删除 跟 踊 后。 

跟踪 点 的 一 个 优点 是 允许 方便 地 添加 额外 信息 ， 如 $FUNCTION 会 把 当前 的 函数 名 添加 到 输出 信息 中 。 虽 
然 这 个 信息 可 以 用 Debug 和 Trace 命令 来 编写 ， 但 比较 难 。 总 之 ， 输 出 调试 信息 的 两 种 方法 是 : 

e 诊断 输出 : 总 是 要 从 应 用 程序 中 输出 调试 结 梨 时 使 用 这 种 方法 ， 尤 其 是 在 要 输出 的 字符 串 比 较 复 杂 ， 

涉及 几 个 变量 或 许多 信息 的 情况 下 ， 使 用 该 方法 比较 合适 。 另 外 ， 如 果 要 在 执行 发 布 版 本 的 应 用 程序 
的 过 程 中 进行 输出 ，Trace 命令 经 常 是 唯一 选择 。 
e RIRA: 调试 应 用 程序 时 ， 如 果 硕 望 快速 输出 重要 信息 ， 以 便 消 除 语 义 错 误 ， 应 使 用 跟 踩 点 。 
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7.1.2 ”中断 模式 下 的 调试 

本 半 白 述 的 剩余 调试 拷 术 在 中 断 模 式 下 工作 。 可 以 通过 几 种 方式 进入 这 种 模式 ， 这 些 方式 都 会 以 菜 种 方式 
暂停 程序 的 执行 。 

1. 进入 中 断 模式 

进入 中 断 模式 的 最 简单 方式 是 在 运行 应 用 程序 时 ， 单 击 IDE 中 的 Pause 按钮 。 这 个 Pause 按钮 在 Debug T. 
具 栏 上 ， 你 应 把 该 工具 栏 添加 到 Visual Studio 默认 显示 的 工具 栏 中 。 为 此 ， 石 击 工具 栏 区 域 ， 然 后 选择 Debug, 
这 个 工具 栏 如 图 7-6 所 示 。 

在 这 个 工具 栏 上 ， 前 3 个 按钮 可 以 手动 控制 中 断 。 在 图 7-6 上 ， 它们 显示 为 灰色 ， 因 为 在 程序 没有 运行 时 ， 
它们 是 不 能 工作 的 。 在 后 面 的 章节 需要 其 他 按钮 时 ， 再 介绍 它们 。 

运行 一 个 应 用 程序 时 ， 工 具 栏 如 图 7-7 所 示 。 


图 7-6 图 7-7 


现在 ， 残 可 以 使 用 之 前 显示 为 灰色 的 3 个 按钮 了 。 使 用 它们 可 以 : 

e 暂 集 应 用 程序 的 执行 ， 进 入 中 断 模式 

e 完全 停止 应 用 程序 的 执行 (不 进入 中 断 模式 ， 而 是 退出 应 用 程序 ) 

e 重新 局 动 应 用 程序 

暂停 应 用 程序 是 进入 中 断 模式 的 最 简单 方式 ， 但 这 并 不 能 更 好 地 控制 停止 程序 运行 的 位 置 。 我 们 可 能 会 停 
在 应 用 程序 正常 暂停 的 地 方 ， 例 如 ， 要 求 用 户 输入 信息 。 还 可 以 在 长 时 间 的 操作 或 循环 过 程 中 进入 中 断 模式 ， 
但 停止 位 置 可 能 相当 随机 。 一 般 情 况 下 ， 最 好 使 用 断 点 。 


断 点 

靳 点 是 源 代码 中 目 动 进入 中 断 模 式 的 标记 。 它 们 可 以 配置 为 : 

e 多 到 断 点 时 ， 立 即 进入 中 断 模式 

e 遇 到 断 点 时 ， 如 果 布 尔 表达 式 的 值 为 tue， 丈 进入 中 断 模 式 

e 遇 到 东 断 点 一 定 的 次 数 后 ， 进 入 中 断 模式 

e 在 遇 到 断 点 时 ， 如 果 目 从 上 次 遇 到 断 点 以 来 变量 的 值 发生 了 变化 ， 融 进入 中 断 模式 

注意 ， 上 述 功能 仅 能 用 于 调试 程序 。 如 果 编 详 发 布 程序 ， 将 忽略 所 有 上 断 氮 。 

添加 断 点 有 几 种 方法 。 要 添加 简单 断 点 ， 当 遇 到 该 断 点 所 在 的 代 人 码 行 时 ， 就 中 断 执 行 ， 可 以 单 击 该 代码 行 
左边 的 灰色 区 域 。 另 外 可 以 选择 Debug | Toggle Breakpoint 菜单 项 ， 或 者 按 下 F9 键 ， 将 断 点 放 在 有 焦点 的 代码 
AT b. 

IB AEST WS ea ATT lel al, AAT AS i ea, WB 7-8 所 示 。 


k=] ChO7Ex01 > S, ChO7Ex01.Program - | 8. Maxima(int[] integers, out int[] indices) ~ 
= static void Main(string[] args) 
{ 
int[] testArray = { 4, 7, 4, 2, 7, 3, 7, 8, 3, 9, 1, 9 }; 
int maxVal = Maxima(testArray, out int[] maxValIndices); 
WriteLine($"Maximum value {maxVal} found at element indices:"); 
foreach (int index in maxVallndices) 


ReadKey(); 


static int Maxima(int[] integers, out int[] indices) 


图 7-8 
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使 用 Breakpoints 窗口 (前 面 介绍 过 局 用 该 窗口 的 方法 ) 还 可 以 但 看 文件 中 的 断 点 信息 。 在 Breakpoints 
窗口 中 ， 可 以 禁用 断 点 、 删 除 断 点 、 编 辑 断 点 的 属性 。 还 可 以 为 断 点 添加 标签 ， 这 是 对 所 选 定 的 断 点 进行 分 组 
的 一 种 便捷 方式 。 注 意 ， 删 除 摘 述 信息 左边 的 记号 后 ， 茶 用 的 断 点 用 未 填充 的 红色 圆圈 来 表示 。 可 以 在 Labels 
列 中 查看 标签 ， 并 按 标签 过 滤 Breakpoints 窗口 中 的 项 。 

这 个 窗口 中 显示 的 Condition 和 Hit Count 列 是 最 有 用 的 两 个 列 。 右 击 断 点 ， 并 选择 Conditions...Expanding 
下 拉 框 ， 通 过 显示 的 如 下 选项 ， 融 可 以 编辑 它们 : 

e Conditional Expression 

e Hit Count 

e Filter 

选择 Conditions... KARE — Tou iile. FEAT uter up EAEEREN, BREAN UBL ET EA 
位 置 仍 在 作用 域内 的 任何 变量 。 Pu, BAC “MOT, Ta ANGUS maxVal>4， 选 择 Is true 选项 ， 在 遇 到 这 个 
断 点 且 maxVal 的 值 大 于 4 时 ， 就 会 触发 该 断 点 。 还 可 以 检查 这 个 表达 式 是 否 有 变化 ， 仅 当 上 生变 化 时 ， 才 会 
触发 断 点 (例如 ， 如 果 在 遇 到 断 点 时 ，maxVal 的 值 从 2 改 为 6， 就 会 触发 该 断 点 )。 

选择 Hit Count 将 弹出 另 一 个 对 话 框 。 在 这 个 对 话 框 中 可 以 指定 在 遇 到 断 点 多 少 次 后 才 触 发 该 断 点 。 该 对 话 
框 中 的 下 拉 列 表 提 供 了 如 下 选项 : 

e 总 是 中 断 ( 默 认 值 ) 

e 在 Hit Count 等 于 多 少 次 时 中 断 

e 在 Hit Count 是 某 个 数 的 倍数 时 中 断 

e 在 Hit Count 大 于 或 等 于 多 少 次 时 中 断 

所 选 的 选项 与 在 选项 和 旁边 的 文本 框 中 输入 的 值 共同 确定 断 点 的 行为 。 这 个 计数 在 比较 长 的 循环 中 很 有 用 ， 例 
如 ， 在 执行 了 前 5000 次 循环 后 需要 中 断 。 如 果 不 这 么 做 ， 中 断 并 重启 5000 次 是 很 痛 苗 的 。 


进入 中 断 模式 的 其 他 方式 

进入 中 断 模 式 还 有 两 种 方式 。 一 种 是 在 抛 出 一 个 未 处 理 的 异 彰 时 选择 进入 该 模式 。 这 种 方式 在 本 草 后 面 讨 
论 到 错误 处 理 时 论述 。 另 一 种 方式 是 在 生成 一 条 判定 语句 (assertiom) 时 中 断 。 

判定 语句 是 可 以 用 用 户 定 义 的 消 恩 中 断 应 用 程序 的 指令 。 它 们 第 用 于 应 用 程序 的 开 友 过 程 ， 作 为 测试 程序 
能 侣 平 请 运行 的 一 种 方式 。 例 如 ， 在 应 用 程序 的 茶 一 处 要 求 给 定 的 变量 值 小 于 10， 此 时 就 可 以 使 用 一 条 判定 语 
句 ， 确 定 它 是 否 为 tue， 如 果 不 是 ， 就 中 断 程 序 的 执行 。 当 遇 到 判定 语句 时 ， 可 以 选择 Abort， 终 止 应 用 程序 的 
执行 ; 也 可 以 选择 Retry， 进 入 中 断 模 式 ， 还 可 以 选择 Ignore， 让 应 用 程序 像 往常 一 样 继续 执行 。 

与 前 面 的 调试 输出 函数 一 样 ， 判 定 函 数 也 有 两 个 版 本 : 

® Debug.Assert() 

e Trace.Assert() 

其 Debug 版 本 也 是 仅 用 于 编 诺 调试 程序 ， 而 Trace 版 本 仅 用 于 编 详 发 布 程序 。 

XPS Bi 3 个 参数 。 第 一 个 参数 是 一 个 布尔 值 ， 其 值 为 false 会 触 友 判定 语 铝 。 第 二 、 第 三 个 参数 是 两 
个 字符 串 ， 分 别 把 信息 写 到 弹出 的 对 话 框 和 Output 窗口 中 。 上 面 的 示例 需要 一 个 函数 调用 ， 如 下 所 示 : 


Debug.Assert (myVar < 10, "myVar is 10 or greater.", 
"Assertion occurred in Main()."); 


Axe in AE S CE FP IR] 1-358 FH ERA S n] UA ch EN AS Acti EET, 其 中 包含 Trace. Assert() 
函数 ， 以 了 解 应 用 程序 的 运行 情况 。 如 果 触 发 了 判定 语句 ， 用 户 就 会 收 到 通知 ， 把 这 些 消 恩 传递 给 开发 人 员 。 
这 样 ， 即 使 开 友 人 员 不 知道 错误 是 如 何 发 生 的 ， 也 可 以 改正 这 个 错误 。 

例如 ， 在 第 一 个 字符 串 中 提供 有 关 错 误 的 简短 描述 ， 在 第 二 个 字符 串 中 提供 下 一 步 该 如 何 操作 的 指示 : 


Trace.Assert(myVar « 10, "Variable out of bounds.", 
"Please contact vendor with the error code KCW001."); 
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WIR fU. SIR RAE), HRE BoA 7-9 所 示 的 对 话 框 。 
Assertion Failed: Abort- Quit, Retry=Debug, lgnore- Continue 
(x) Variable out of bounds. 


Please contact vendor with the error code KCW001. 
at AssertionDemo.Program.Main(String[] args) in 


CABeginningCSharp AChapterü/VAssertionDemoXP rogram.cs:line 15 


Abt | — Retry | ignore | 


图 7-9 


诚然 ， 这 并 不 是 最 友好 的 对 话 框 ， 因 为 它 包含 了 许多 令 人 感到 迷惑 的 信息 。 但 如 果 用 户 给 开发 人 员 发 送 了 
有 关 这 个 错误 的 屏幕 图 ， 开 发 人 员 就 可 以 很 快 找 出 问题 所 在 。 

下 一 个 要 论述 的 主题 是 应 用 程序 中 断 ， 以 及 进入 中 断 模式 后 ， 我 们 可 以 做 什么 。 一 般 情 况 下 ， 进 入 中 断 模 
式 的 目的 是 找 出 代码 中 的 错误 (或 确信 程序 工作 正常 )。 一 旦 进入 中 断 模式 ， 就 可 以 使 用 各 种 技巧 分 析 代 码 ， 并 
分 析 应 用 程序 在 暂停 时 的 状态 。 

2. 监视 变量 的 内 容 


监视 变量 的 内 容 是 Visual Studio 希 助 我 们 使 工作 变 得 简单 的 一 个 例子 。 碍 看 变量 值 的 最 简单 方式 是 在 中 断 
模式 下 ， 使 鼠标 指 回 源 代码 中 的 变量 名 ， 此 时 会 出 现 一 个 工具 提示 ， 显 示 该 变量 的 信息 ， 其 中 包括 该 变量 的 当 
前 值 。 

还 可 禹 腕 显示 整个 表达 式 ， 以 相同 方式 得 到 该 表达 式 的 结果 。 对 于 比较 复杂 的 值 (例如 数组 )， 甚 至 可 以 扩 
展 工具 提示 中 的 值 ， 得 看 各 个 数组 元 闲 项 。 

甚至 可 将 这 些 工 具 提示 窗口 固定 到 代码 视图 中 ， 这 对 于 得 看 特别 感 兴趣 的 变量 很 有 帮助 。 固 定 的 工具 提示 
会 一 直 显 示 ， 所 以 即使 在 停止 并 重 局 调试 后 ， 仍 然 可 以 看 到 它们 。 甚 至 可 以 在 固定 的 工具 提示 中 添加 注释 ， 移 
动工 具 提 示 窗 口 ， 查 看 变量 的 最 后 一 个 值 ， 即 使 应 用 程序 并 没有 运行 也 同样 如 此 。 

注意 , 在 运行 应 用 程序 时 , IDE 中 各 个 窗口 的 布局 发 生 了 变化 。 默认 情况 下 , 在 运行 期 间 会 发 生 如 下 变化 ( 变 
化 的 情况 因 有 具体 的 安 疙 而 异 ): 

e Properties 窗口 和 其 他 一 些 窗 口 会 消失 ， 其 中 可 能 包括 Solution Explorer 窗口 

e 会 打开 Tools 诊断 窗口 ， 显 示 Summary. Events. Memory Usage 和 CPU Usage 

e ErorList 窗口 会 被 IDE 窗口 底部 的 两 个 新 窗口 替代 

e 新 窗口 中 会 出 现 几 个 新 的 选项 卡 

新 的 屏 帮 布局 如 图 7-10 所 示 。 这 可 能 与 谈 者 的 显示 情况 不 完全 相同 ， 一 些 选项 卡 和 窗口 可 能 不 完全 匹配 。 
但 是 ， 这 些 窗 口 的 功能 (后 面 将 讨论 ) 是 相同 的 ， 这 个 显示 完全 可 以 通过 View 和 Debug | Windows 来 单 来 定制 (在 
中 断 模式 下 )， 也 可 以 通过 在 屏幕 上 拖 动 窗口 ， 重 新 设 定 它们 的 位 置 。 

左下 角 的 新 窗口 在 调试 时 非常 有 用 ， 它 允许 在 中 断 模 式 下 ， 密 切 监 视 应 用 程序 的 变量 值 。 它 包含 3 个 选项 
卡 ， 如 下 所 示 : 

e Autos— 当前 和 前 面 的 语句 使 用 的 变量 (Ctrl+D, A) 

e Locals 一 一 作用 域内 的 所 有 变量 (CtrlHtD, L) 

e Watch 一 一 可 定制 的 变量 和 表达 式 显 示 ( 其 中 对 为 1~4 的 值 ， 在 Debug | Windows | Watch E) 
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T on Visual Stua 
File Edit View Propect — Build Debug Team Tool Test Analyze — Window Help 
o - E NE, l b Continue - P . | 5 > +s? "X. hn 35x RN 


: ] *- Diagnostik Tools x 
ES ChOvExO - | "S ChO7Ex01 Program - | $, Mainistring[] args) -| & aay 
i foreach (int index in maxVal Indices) 
A i Diagnostics session: 0 seconds (49 ms selected) 
oe x WriteLine( index); | | &00ens Bims 
. a Events 
J 


Jagjag uo ngos 
a 


} 
ReadKey(); 
H 


static int Maxima(int[] integers, out int[] indices) 4 Process Memory Y GC W Snapshot @ Private Bytes 
| 100 
Debug. WriteLine("Maximum value search started." ) 4 
indices = new int[1]; 
int maxVal = integers[6]; 0 
indices([@] = e; 4 CPU (% of all processors) 
100 


int count = 1; 
Debug .WriteLine( string. Format ( 
"Maximus value initialized to (maxVal), at element index 0.")); 
for (int 1 = 1; i € integers.Length; i+) 0 
| r 
1% = 4 Summary Events Memory Usage CPU Usage 
Qutput Events 


Show output from Debug Show Events (1 of 1) 
How looking at element at index 10 Memary Usage 
Wow looking at element at index 11. 

How looking at element at index 11 E Take Snapshot 
Duplicate maximum found at element index 11. 

Maximum value 9 found, with 4 occurrences. CPU Usage 

Maximum value search completed, $ Enable CPU Profiling 
a 


Locals š m i " " r " " $ ; ê è $ T $ à i ; bi r ; è ; è - g x 
Mame Value Type 
@ snot [string[0]) string[] 
b @ restArray fim 12] imt] 
@ maxval 9 int 
Pow maxValindices bmi 21) mt] 
i index 9 im 
Locas Watch 1 Call Stack Exception Settings Immediate Window 
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这 些 选项 卡 的 工作 方式 或 多 或 少 有 些 类 似 ， 并 根据 它们 的 特定 功能 添加 了 各 种 附加 特性 。 一 般 情况 下 ， 每 
个 选项 卡 都 包含 一 个 变量 列表 ， 其 中 包括 变量 的 名 称 、 值 和 类 型 等 信息 。 更 复杂 的 变量 (如 数组 ) 可 以 使 用 变量 名 
左边 的 十 和 - (展开 / 折 营 ) 符 号 进一步 查看 ， 它 们 的 内 容 可 以 树 状 视图 的 方式 显示 。 例 如 ， 在 前 面 的 示例 中 ， 
在 代码 中 放置 了 一 个 断 点 ， 得 到 的 Locals 选项 卡 如 图 7-11 所 示 ， 其 中 显示 了 数组 变量 maxValIndices 的 展开 
视图 。 


. Name Value 
@ args [string[0]) string[] 
b € testAnay tint[12]] int[] 


[2 maxVallndices |nt[2 int] | 
| int 


9 


11 int 
| int 


int 


图 7-11 


在 这 个 视图 中 , 还 可 以 编辑 变量 的 内 容 ,。 它 有 效 地 绕 过 了 前 和 面 代码 中 的 其 他 变量 赋值 , 为 此 , 只 需要 在 Value 
列 中 为 要 编辑 的 变量 输入 一 个 新 值 即 可 。 也 可 以 将 这 种 技巧 用 于 其 他 情况 ， 例 如 ， 需 要 修改 代码 才能 编辑 变量 
值 的 情况 。 

可 通过 Watch 窗口 监视 特定 变量 或 涉及 特定 变量 的 表达 式 。 要 使 用 这 个 窗口 ， 只 需要 在 Name 列 中 键入 变 
量 名 或 表达 式 ， 束 可 以 查看 它们 的 结果 。 注 意 ， 并 不 是 应 用 程序 中 的 所 有 变量 在 任何 时 候 和 都 在 作用 域内 ， 并 在 
Watch 窗口 中 对 变量 做 出 标记 。 例 如 ， 图 7-12 显示 了 一 个 Watch 窗口 ， 其 中 包含 几 个 示例 变量 和 表达 式 ， 在 明 
到 Maxima0 函 数 末尾 前 面 的 一 个 断 点 时 ， 会 显示 这 个 Watch 窗口 。 
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Name Value Type 
@ maxVal * count 18 int 
@ indices[1] 11 int 

b @ testAray fint[12]) ( intil 


E 
Output Watch 1 
图 7-12 
testArray 数组 对 于 Main0 来 说 是 局 部 数组 ， 所 以 在 该 图 中 没有 值 ， 它 是 灰 显 的 。 
3. 单 步 执行 代码 
前 面 介 绍 了 如 何在 中 断 模 式 下 查看 应 用 程序 的 运行 情况 ， 下 面 讨 论 如 何在 中 断 模式 下 使 用 IDE 单 步 执行 代 
码 ， 查 看 代码 的 准确 执行 结果 。 人 们 的 思维 速度 不 会 比 计算 机 运行 得 更 快 ， 所 以 这 是 一 个 极 有 价值 的 技巧 。 
Visual Studio 进入 中 断 模 式 后 ， 在 代码 视图 的 左边 ， 马 上 要 执行 的 代码 旁边 会 出 现 一 个 黄色 第 头 光标 (如 果 
使 用 断 点 进入 中 断 模 式 ， 该 光标 最 初 应 显示 在 断 点 的 红色 圆圈 中 )， 如 图 7-13 所 示 。 


Program.cs # 5 


[k=] ChO7Ex01TracePoints - ^, ChO7Ex01TracePoints.Program -| 名 Main(string[] args) 
= static void Main(string[] args) 


int maxVal = Maxima(testArray, out int[] maxValIndices); 
WriteLine($"Maximum value {maxVal} found at element indices:"); 
foreach (int index in maxValIndices) 

{ 


WriteLine( index); 


} 
ReadKey(); 


图 7-13 


kM AN f EAP BRAR ET TT BU. PERK, BY EPA T IMT. Alt, EAHA SU 
的 其 他 一 些 Debug 工具 栏 按钮 ， 如 图 7-14 所 示 。 


图 7-14 


第 6、 第 7、 第 8 个 图 标 控 制 了 中 断 模式 下 的 程序 流 。 它 们 依次 是 : 

e Step Into— 执行 并 移动 到 下 一 条 要 执行 的 语句 上 

e Step Over 一 一 同上 ， 但 不 进入 舱 套 的 代码 块 ， 包 括 函 数 

e Step Out 一 一 执行 到 代码 块 的 末尾 处 ， 在 执行 完 该 语句 块 后 ， 重 新 进入 中 断 模 式 

如 果 要 查看 应 用 程序 执行 的 每 个 操作 ， 可 以 使 用 Step Into 按 顺 序 执行 指令 ， 这 包括 在 函数 中 的 执行 ， 如 上 
面 示例 中 的 Maxima0。 当 光标 到 达 第 16 行 ， 调 用 Maxima0 时 ， 单 击 这 个 图 标 ， 会 使 光标 移 到 Maxima( FR 2X Pj 
部 的 第 一 行 代 码 上 。 而 如 果 光 标 移 到 第 16 行 时 单 击 Step Over， 就 会 使 光标 移动 到 第 17 行 ， 不 进入 Maxima() 
中 的 代码 (但 仍 执 行 这 段 代 码 )。 如 果 蛙 步 执 行 到 不 感 兴趣 的 函数 , 可 以 单 击 Step Out, 返回 到 调用 该 函数 的 代码 。 
在 单 步 执行 代码 时 ， 变 量 的 值 可 能 会 及 生变 化 。 注 意 观察 上 一 节 讨 论 的 Watch 窗口 ， 可 以 看 到 变量 值 的 变化 
情况 。 

通过 右 击 代码 行 并 选择 Set Next Statement， 或 将 黄色 第 头 拖 到 不 同 的 代码 行 ， 也 可 以 更 改 接 下 来 要 执行 的 
代码 行 。 这 有 时 是 不 可 行 的 ， 例 如 当 跳 过 变量 初始 化 时 。 但 是 ， 当 跳 过 存在 问题 的 代码 行 来 查看 发 生 的 情况 时 ， 
或 加 后 移动 般 头 来 重复 执行 代码 时 ， 这 种 方法 是 非 钊 有 用 的 。 

在 存在 语义 错误 的 代码 中 ， 这 些 技巧 也 许 是 最 有 效 的 。 可 以 单 步 执行 代码 ， 当 执行 到 有 错误 的 代码 时 ， 错 
误会 像 正 党 运行 程序 那样 发 生 。 或 者 可 以 修改 执行 代码 ， 让 语句 多 次 执行 。 在 这 个 过 程 中 ， 可 以 监视 数据 ， 看 
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看 什么 地 方 出 了 错 。 本 章 后 面 将 使 用 这 个 技巧 但 看 示例 应 用 程序 的 执行 情况 。 

4. Immediate 和 Command 窗口 

通过 Command 和 Immediate 窗口 (在 Debug Windows 菜单 下 )， 可 以 在 运行 应 用 程序 的 过 程 中 执行 命令 。 通 
过 Command 窗口 可 以 手动 执行 Visual Studio 操作 (例如 ， 沫 单 和 工具 栏 操作 )，Immediate 窗口 可 以 执行 与 当前 
正在 执行 的 源 代 码 不 同 的 额外 代码 ， 以 及 计算 表达 式 。 

Visual Studio 中 的 这 些 窗口 在 内 部 是 链接 在 一 起 的 。 甚 至 可 以 在 它们 之 间 切 换 : 输入 命令 immed， 可 以 从 
Command 窗口 切换 到 Immediate 窗口 ; 输入 cmd， 可 以 从 Immediate 窗口 切换 到 Command 窗口 。 

下 面 详 细 讨论 Immediate 窗口 ， 因 为 Command 窗口 仅 适 用 于 复杂 的 操作 。Immediate 窗口 最 简单 的 用 法 是 
TARA, ARR Watch 窗口 中 的 一 次 性 使 用 。 为 此 ， 只 需要 键入 一 个 表达 式 ， 并 按 回 车 键 即 可 。 接 者 就 会 
显示 请 求 的 信息 ， 如 图 7-15 所 示 。 

可 在 这 里 修改 变量 的 内 容 ， 如 图 7-16 所 示 。 


Immediate Window 


Immediate Window testArray[3] * 18 
'testArray[3] * 18 A 28 
= testArray[3] += 7 
| 9 
4 d 
图 7-15 7-16 


大 多 数 情 况 下 ， 使 用 前 和 面 介 绍 的 变量 监视 窗口 更 容易 得 到 相同 的 效果 ， 但 这 个 技巧 对 于 调整 变量 值 和 测试 
表达 式 很 方便 。 

5. Call Stack 窗口 

这 是 最 后 一 个 要 讨论 的 窗口 ， 它 摘 述 了 程序 是 如 何 执 行 到 当前 位 置 的 。 简 言 之 ， 该 禾 口 显示 了 当前 函数 、 
调用 它 的 函数 以 及 调用 该 函数 的 函数 ( 即 一 个 藤 人 至 的 函数 调用 列表 )。 调 用 的 确切 位 置 也 被 记录 下 来 。 

在 前 面 的 示例 中 , 在 执行 到 MaximaO 时 进入 中 断 模式 , 或 者 使 用 代码 单 步 执行 功能 移动 到 这 个 函数 的 内 部 ， 
得 到 如 图 7-17 所 示 的 信息 。 


@ ChO7Ex01Tracepoints.exe!ChO7Ex01Tracepoints.Program.Main(string[] args) Line 17 Cë 
[External Code] 
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如 果 双 击 茶 一 项 ， 束 会 移动 到 相应 的 位 置 ， 这 样 束 可 以 跟 踊 代码 执行 到 当前 位 置 的 过 程 。 第 一 次 检测 错误 
时 ， 这 个 窗口 非 第 有 用 ， 因 为 它们 可 以 僵 看 临近 错误 发 生 时 的 情况 。 对 于 常用 函数 中 出 现 的 错误 ， 这 有 助 于 找 


7.2 错误 处 理 


本 章 的 第 一 部 分 讨论 如 何在 应 用 程序 的 开发 过 程 中 得 找 和 改正 错误 , 使 这 些 错误 不 会 在 发 布 的 代码 中 出 现 。 
但 有 时 ， 我 们 知道 可 能 会 有 错误 发 生 ， 但 不 能 100% 地 肯定 它们 不 会 友 生 。 此 时 ， 最 好 能 预料 到 错误 的 发 生 ， 编 
写 足 够 健壮 的 代码 以 处 理 这 些 错误 ， 而 不 必 中 断 程 序 的 执行 。 

错误 处 理 就 是 用 于 这 个 目的 。 本 节 将 介绍 异常 和 处 理 它们 的 方式 。 异常 是 在 运行 期 间 代 码 中 产生 的 错误 ， 
或 者 由 代码 调用 的 函数 产生 的 错误 。 这 里 的 “错误 ”定义 要 比 以 前 更 含糊 ， 因 为 异常 可 能 是 在 函数 等 结构 中 
手工 产生 的 。 例 如 ， 如 果 函 数 的 一 个 字符 串 参 数 不 是 以 a 开头 ， 就 产生 一 个 异常 。 严 格 来 讲 ， 从 该 函数 的 外 部 
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看 这 并 不 是 一 个 错误 ， 但 调用 该 函数 的 代码 会 把 它 看 成 错误 。 
在 本 书 前 面 已 经 遇 到 几 次 异 利 了 。 节 简单 的 示例 是 试图 定位 一 个 超出 范围 的 数组 元 率 ， 例 如 : 


int[] myArray = (1, 2, 3, 4 }; 
int myElem = myArray[4]; 


sere on PR aS. HP REP MT: 
Index was outside the bounds of the array. 


异常 在 名 称 空间 中 定义 ， 大 多 数 异 常 的 名 称 都 清晰 地 说 明了 它们 的 用 途 。 在 这 个 示例 中 ， 产 生 的 异常 称 为 
System .IndexOutO 人 RangeException， 说 明 我 们 提供 的 myArray 数组 索引 不 在 允许 使 用 的 索引 范围 内 。 只 有 在 异 
党 未 处 理 时 ， 这 个 信息 才 会 显示 出 来 ， 应 用 程序 也 才 会 中 断 执 行 。 下 一 节 将 讨论 如 何 处 理 异 第 。 

[.2.1 try...catch.. finally 

CHE a AM is (Structured Exception Handling, SEH) iY. FA 3 个 关键 字 可 以 标记 出 能 处 理 异 
TARBAIS, WIRE. MEARE OA a. Tak TIN 3 个 关键 字 是 try、catch 和 finally. 
它们 都 有 一 个 关联 的 代码 块 ， 必 须 在 连续 的 代码 行 中 使 用 。 其 基本 结构 如 下 : 


try 
{ 


} 
catch («XexceptionType^? e) when (filterIsTrue) 
«await methodName (e) ;> 


} 
finally 
{ 


<await methodName;> 
} 
也 可 在 catch 或 finally 块 内 使 用 C& 6 中 引入 的 awaits await RESP 36r CHE ETA, EL 
SW, 且 可 以 提高 应 用 程序 的 总 体 性 能 和 啊 应 能 力 。 利 用 async 和 await 关键 字 进行 异步 编程 的 相关 内 容 在 本 书 中 
不 讨论 ; 然而 ， 这 些 关 键 字 向 化 了 这 项 编程 技术 的 实现 ， 所 以 强烈 建议 学 习 它 们 。 
也 可 以 只 有 try 块 和 finally $, 而 没有 catch 块 , 或 者 有 一 个 try RAS catch 块 。 如 果 有 一 个 或 多 个 catch 
块 ，finally 块 就 是 可 选 的 ， 否 则 就 是 必需 的 。 这 些 代码 块 的 用 法 如 下 : 

etry 一 一 包含 抛 出 异常 的 代码 (在 谈 到 异常 时 ，C# 语 言 用 “ 抛 出 ”这 个 术语 表示 “生成 ”或 “导致 ”)。 

e catch 一 一 包含 抛 出 异常 时 要 执行 的 代码 。catch 块 可 使 用 <exceptionType>， 设 置 为 只 啊 应 特定 的 异常 类 
型 (如 System.IndexOutOfRangeException)， 以 便 提供 多 个 catch 块 。 还 可 以 完全 省 略 这 个 参数 ， 让 通用 
的 catch 块 啊 应 所 有 异常 。C#6 引入 了 一 个 概念 “ 异 帝 过滤 ”， 通 过 在 异 和 类 型 表达 式 后 添加 when X 
键 字 来 实现 。 如 果 发 生 了 该 异常 类 型 ， 且 过 滤 表 达 式 是 tue， 就 执行 catch 块 中 的 代码 。 

e finally 一 一 包含 始终 会 执行 的 代码 ， 如 果 没 有 产生 异 弟 ， 则 在 ty 块 之 后 执行 ， 如 果 处 理 了 异 弟 ， 就 在 
catch 块 后 执行 ， 或 者 在 未 处 理 的 异常 “上 移 到 调用 堆栈 ”之 前 执行 。“ 上 移 到 调用 堆栈 ”表示 ，SEH 
fO VFIICE: try...catch...finally R, WARPRAKE, HWE try RETNA PRE. PO, WIRE 
锐 调 用 的 函数 中 没有 catch RAGES ro. BCFA VA RASPY catch RADE. anon 2t VURUIT] 
catch 块 ， 就 终止 应 用 程序 。finally 块 在 此 之 前 处 理 正 是 其 存在 的 意义 ， 否 则 也 可 在 try...catch...finally 
结构 的 外 部 放置 代码 。 关 于 藤 套 功能 ， 后 面 还 会 进一步 讨论 ， 所 以 现在 有 些 不 明日 也 不 必 担 心 。 

在 try 块 的 代码 中 出 现 异常 后 ， 依 次 发 生 的 事件 如 下 ， 如 图 7-18 所 示 : 

e try 块 在 发 生 异 常 的 地 方 中 断 程序 的 执行 。 

e WRA catch ik, si tribue ALAC RA. MRA catch R, WAIT finally 块 (如 朱 没 
有 catch 块 ， 就 一 定 要 有 finally 3%). 

e WRA catch 块 ， 但 它 与 已 及 生 的 异常 类 型 不 匹配 ， 就 检查 是 任 有 其 他 catch Et. 
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e ”如果 有 catch 块 匹配 已 发 生 的 异常 类 型 , 且 有 一 个 异 弟 过 小 如 是 true, 就 执行 它 包 含 的 代码 ,再 执行 fmally 


块 (如 果 有 的 话 )。 
e WRA catch 块 匹 配 已 发 生 的 异常 类 型 , RARE, MAITE AAS, FUT finally 块 ( 如 
果 有 的 话 )。 


e WR catch 块 都 不 匹配 已 发 生 的 异常 类 型 ， 束 执行 finally 块 ( 如 果 有 的 话 )。 


try 块 中 的 代码 异常 


3] 7-18 


注意 : 

如 果 存 在 两 个 处 理 相同 异常 类 型 的 catch 块 ， 就 只 执行 异常 过 滤器 为 true 的 catch 块 中 的 代码 。 如 果 还 存在 
一 个 处 理 相同 异常 类 型 的 catch 块 ， 但 没有 异常 过 滤器 或 异常 过 滤器 是 false， 就 忽略 它 。 只 执行 一 个 catch 块 的 
代码 ，catch 块 的 顺 厅 不 影响 执行 流 。 

下 和 面 用 一 个 示例 来 说 明 异 党 处 理 。 这 个 示例 以 几 种 方式 抛 出 和 人 处理 异 第 ， 以 便 读 者 了 解 其 机 制 。 


试 一 试 ” 异 常 处 理 : Ch07Ex02\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter07 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch07Ex02。 
(2) 修改 代码 ， 如 下 所 示 ( 这 里 显示 的 行 号 注释 有 助 于 将 代码 与 后 面 讨论 的 内 容 联 系 起 来 ， 在 本 章 的 可 下 载 
代码 中 也 包含 这 些 行 号 ， 以 方便 参考 ): 


class Program 
{ 
static string[] eTypes = { "none", "simple", "index", 
"nested index", "filter" }; 


static void Main(string[] args) 
{ 
foreach (string eType in eTypes) 
{ 
try 
{ 
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WriteLine("Main() try block reached.") ; // Line 21 
WriteLine ($"ThrowException (\"{eType}\") called."); 
ThrowException (eType) ; 


WriteLine("Main() try block continues.") ; // Line 24 
) 
catch (System.IndexOutOfRangeException e) when (eType == "filter") 
{ 
BackgroundColor = ConsoleColor.Red; 
WriteLine("Main() FILTERED System. IndexOutofRangeException" + 
$"catch block reached. Message: \n\"{e.Message}\"") ; 
Resetcolor(); 
} 
catch (System. IndexoutofRangeException e) // Line 33 
{ 
WriteLine("Main() System. IndexOutofRangeException catch " + 
$"block reached. Message: \n\"{e.Message}\"") ; 
} 
catch // Line 38 
{ 
WriteLine("Main() general catch block reached."); 
) 
finally 
{ 
WriteLine("Main() finally block reached.") ; 
} 
WriteLine (); 
} 
ReadFey () ; 
] 
static void ThrowException(string exceptionType) 
{ 


WriteLine ($"ThrowException (\"{exceptionType}\") reached.") ; 
switch (exceptionType) 
{ 
case "none": 
WriteLine ("Not throwing an exception.") ; 
break ; // Line 57 
case "simple": 
WriteLine ("Throwing System.Exception.") ; 
throw new System.Exception () ; // Line 60 
case "index": 
WriteLine ("Throwing System. IndexOutofRangeException."); 


eTypes[5] = "error"; // Line 63 
break; 

case "nested index": 
try // Line 66 
{ 


WriteLine ("ThrowException (\"nested index\") " + 
"try block reached.") ; 
WriteLine ("ThrowException (\"index\") called."); 


ThrowException ("index") ; // Line 71 
) 
catch // Line 73 
{ 
WriteLine ("ThrowException (\"nested index\") general" 
+ " catch block reached."); 
throw; 
) 
finally 
{ 
WriteLine ("ThrowException (\"nested index\") finally" 
+ " block reached."); 
} 
break; 
case "filter": 
try // Line 86 
{ 
WriteLine ("ThrowException(\"filter\") " + 
"try block reached."); 
WriteLine ("ThrowException (\"index\") called."); 
ThrowException ("index") ; // Line 91 
) 
catch // Line 93 
{ 


WriteLine ("ThrowException (\"filter\") general" 
+ " catch block reached."); 
throw; 
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break; 


注意 : 
试 着 将 上 面 代 码 清单 中 第 76 行 和 第 96 行 的 了 how 18 4) EAR, 以 更 好 地 演示 CHO 中 引入 的 异常 过 滤 功 能 。 


(3) 运行 应 用 程序 ， 结 果 如 图 7-19 所 示 。 


图 7-19 


示例 说 明 
这 个 应 用 程序 在 Main0 中 有 一 个 try 块 ， 它 调用 函数 ThrowException(0)。 这 个 函数 会 根据 调用 时 使 用 的 参数 
We: 


e ThrowException("none") 


A RET e 

e ThrowException("simple") —— ^E i, — Rz Fri o 

e ThrowException("index") —— E Ji, System.IndexOutOfRangeException 5:57. © 

e ThrowException("nested index") — 8,75 t H Gf] try 块 ， 其 中 的 代码 调用 ThrowException("index"), ^t 

成 System.IndexOutOfRangeException FF fi o 
e ThrowException("filter") HON try I, ty 块 包含 的 代码 调用 ThrowException("index"), AEA, 
System.IndexOutOfRangeException 异 第 ， 其 中 异 第 过 小 器 是 true. 

其 中 的 每 个 string 参数 都 存储 在 全 局 数组 eTypes 中 ， 在 Main0 函 数 中 和 迭代， 用 每 个 可 能 的 参数 调用 
ThrowException()。 在 从 代 过 程 中 ,会 把 各 种 信息 写 到 控制 全 ,说 明 发 生 了 什么 情况 。 这 段 代 人 码 可 以 使 用 本 章 
前 面 介绍 的 代码 单 步 执 行 技 巧 。 在 执行 代码 的 过 程 中 ， 一 次 执行 一 行 代码 可 以 确切 地 了 解 代码 的 执行 进度 。 

在 代码 的 第 21 行 添 加 一 个 新 断 点 (用 执 认 的 属性 )， 该 行 代码 如 下 : 


WriteLine("Main() try block reached."); 


注意 : 

这 里 使 用 了 本 章 可 下 载 代码 中 的 行 号 来 表示 代码 。 如 果 关 闭 了 行 号 ， 可 以 选择 Tools|Options, Æ Text Editor | 
C£ | General 选项 区 域 打 开 它 们 。 上 面 的 代码 在 注释 中 包含 行 号 ， 这样 读者 在 阅读 这 里 的 说 明 时 就 不 需要 打开 
x4. 
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在 调试 模式 下 运行 应 用 程序 。 程 序 立 即 进 入 中 断 模式 ， 此 时 光标 停 在 第 21 行 上 。 如 果 选 择 变量 监视 窗口 中 
的 Locals 选项 卡 ， 就 会 看 到 eType 当前 是 "none"。 使 用 Step Into 按钮 处 理 第 22 和 第 23 行 ， 看 看 第 一 行文 本 是 
SOAS BPA. RATE Step Into 按钮 单 步 执行 第 23 行 的 ThrowException( Až. 

执行 到 ThrowException0 国 数 后 ，Locals 窗口 会 友 生 变化 。eType 和 args 超出 了 作用 域 (因为 它们 是 Main() 
的 局 部 变量 )， 我 们 看 到 的 是 exceptionType 局 部 参数 ， 它 当然 是 "mone"。 继 续 单 击 Step Into, FIA switch 语句 ， 检 
ft exceptionType 的 值 ， 执 行 代 码 ， 把 字符 串 Not throwing an exception 写 到 屏 磊 上。 在 执行 第 57 行 上 的 break 
语句 时 ， 将 退出 函数 ， 继 续 处 理 Main0 中 的 第 24 行 代 码 。 因 为 没有 抛 出 异常 ， 所 以 继续 执行 try 块 。 

接着 处 理 finally 块 。 再 单 击 Step Into 几 次 ， 执 行 完 finally 块 和 foreach 的 第 一 次 循环 。 下 次 执行 到 第 23 fT 
时 ， 使 用 另 一 个 参数 "simple" 调 用 ThrowException(). 

继续 使 用 Step Into 单 步 执行 ThrowException0， 最 终 会 执行 到 第 60 íT: 


throw new System.Exception(); 


这 里 使 用 CG# 的 throw KEEFER- T T6» TRAIT ACE 3- be aati FARES A WAT 
pH, TALLEY System 4 TE EIBI RIETI — T Ses System.Exception. 


注意 : 


在 case 块 中 使 用 throw 时 ， 不 需要 break 724), 1A) throw 就 可 以 结束 该 块 的 执行 。 


在 使 用 Step Into 执行 这 条 语句 时 , ESB 38 行 开始 执行 一 般 的 catch 块 。 因 为 与 第 26 行 开始 的 catch 块 都 
不 匹配 ， 所 以 执行 这 个 一 般 的 catch 块 。 单 步 执行 这 段 代 码 ， 然 后 执行 finally 块 ， 最 后 返回 到 男 一 个 循环 周期 ， 
该 循环 在 第 23 行 用 一 个 新 参数 调用 ThrowException0， 这 次 的 参数 是 "index"。 

这 次 ThrowException0 在 第 63 行 生 成 一 个 异 第 : 


eTypes[5] = "error"; 


eTypes 是 一 个 全 局 数组 ， 所 以 可 以 在 这 里 访问 它 。 但 是 这 里 试图 访问 数组 中 的 第 6 T7038 CREAR SIM 0 开始 
计数 )， 这 会 生成 一 个 System IndexOutOfRangeException 5555 o 

这 次 Main0 中 有 多 个 匹配 的 catch 块 ， 其 中 第 26 行 的 一 个 catch 块 有 一 个 异常 过 滤器 表达 式 (eType 
—"filter"), $ 33 行 的 男 一 个 catch 块 没有 异常 过 小 器 表达 式 。 和 存储 在 eType 中 的 值 当 前 是 "index"， 因 此 异常 过 
滤器 表达 式 是 false， 跳 过 这 个 catch Bi. 

单 步 执 行 到 下 一 个 catch 块 ， 从 第 33 行 开始 。 这 个 块 中 调用 的 WriteLine0 使 用 e-Message, 输出 存储 在 异 当 
中 的 消 恩 (可 以 通过 catch 块 的 参数 访问 异常 )。 之 后 再 次 日 步 执行 finally 块 (而 不 是 第 二 个 catch H, AARC 
经 处 理 完 毕 )。 返 回 循环 ， 再 次 调用 第 23 行 的 ThrowException()- 

在 执行 到 ThrowException0 中 的 switch 结构 时 , 进入 一 个 新 的 try 块 , 从 第 67 行 开始 。 在 执行 到 第 71 行 时 ， 
将 遇 到 ThrowException0 的 一 个 散 套 调用 ， 这 次 使 用 " index" 人 参数。 可 以 使 用 Step Over 按钮 跳 过 其 中 的 代码 行 ， 
因为 前 面 已 经 单 步 执行 过 了 。 与 前 面 一 样 ， 这 个 调用 生成 一 个 System.IndexOutOfRangeException 异常 。 但 这 个 
FEE ThrowException('P I] XE try...catch...finally 结构 中 人 处理 。 这 个 结构 没有 明确 匹配 这 种 异 第 的 catch ER, Br 
以 执行 一 般 的 catch 块 ( 从 第 73 行 开始 )。 

继续 单 步 执行 代码 ， 这 次 到 达 ThrowException0 中 的 switch 结构 时 ， 进 入 一 个 新 的 try 块 ， 从 第 86 行 开 始 。 
BIAS 91 行 时 ， 和 以 前 一 样 ， 执 行 一 个 嵌 套 调用 ThrowException0 。 但 是 ， 这 次 处 理 Main0 中 System. 
IndexOutOfRangeException 51:755 [f] catch 块 会 检查 过 小 表达 式 (eType = = "filter"))， 其 结果 是 tme， 所 以 执行 该 catch 
块 ， 而 不 是 处 理 System IndexOutOfRangeException 的 、 没 有 异常 过 滤器 的 catch 块 。 

与 前 和 面 的 异 沼 处 理 一 样 ， 现 在 单 步 执行 这 个 catch 块 ， 以 及 关联 的 finally 块 ， 最 后 返回 到 函数 调用 的 末尾 
处 。 但 是 它们 有 一 个 重要 区 别 : 抛 出 的 异常 是 由 ThrowException0 中 的 代码 处 理 的 。 这 就 是 说 ， 异 常 并 没有 留 
给 Main0 处 理 ， 所 以 直接 进入 finally 块 ， 之 后 应 用 程序 中 断 执行 。 
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7.2.2 throw 表达 式 


在 前 面 的 示例 中 ，throw 仪 用 在 对 已 经 发 生 的 操作 进行 编码 的 代码 语句 中 。 在 表达 式 中 也 可 以 使 用 throw, 
如 下 所 示 : 

friend ?? throw new ArgumentNullException(paraName: nameof(friend), message: "null") 

上 面 的 代码 段 中 使 用 了 双 问 号 2?)， 称 为 空 值 合并 操作 符 (null-coalescing operator)， 检 查 所 赋 的 值 是 否 为 
null。 硅 为 aol， 则 抛 出 ArgumentNullException 函数 ， 奋 则 将 该 值 赋 给 变量 。 
7.2.3” 列 出 和 配置 异常 

NET Framework 包含 许多 异 第 类 型 ， 可 以 在 代码 中 日 由 抛 出 和 处 理 这 些 类 型 的 异 第 。IDE 提供 了 一 个 对 话 
框 ， 可 以 检查 和 编辑 可 用 的 异 弟 。 使 用 Debug | Windows | Exceptions Settings 六 单项 (或 按 下 CtrlHD，PE) 可 打开 
VoM wie, ud 7-20 所 示 。 


—— "T rum foe eae 
Exception Setting 


Y- Rms EE sor 


Break When Thrown Conditions 
POM C++ Exceptions 

O Common Language Runtime Exceptions 
P C] GPU Memory Access Exceptions 


b E| Java Exceptions 

P Nl JavaScript Runtime Exceptions 
P E| Managed Debugging Assistants 
P C] Nodejs Exceptions 

P[] WebKit JavaScript Exceptions 

b |I Win32 Exceptions 


图 7-20 
该 对 话 框 按照 类 别 和 .NET Fe 4 $25 18] EIU HAS. 展开 Common Language Runtime Exceptions 的 加 号 , 就 可 
以 看 到 System 名 称 空 间 中 的 异 弟 ， 这 个 列表 包括 上 和 面 使 用 的 System.IndexOutOfRangeException 5$ 7i o 
每 个 异 沼 都 可 以 使 用 异常 类 型 旁边 的 复 选 框 来 配置 。 使 用 (break when)Thrown 时 ， 即 使 是 对 于 已 处 理 的 异 
T PEHA TIA o 
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(1) “使 用 Trace .WriteLine0 要 优 于 使 用 Debug .WriteLine0， 因 为 调试 版 本 仅 能 用 于 调试 程序 .” 这 个 观点 正 
确 吗 ? 为 什么 ? 

(2) 为 一 个 简单 的 应 用 程序 编写 代码 ， 其 中 包含 一 个 循环 ， 该 循环 在 运行 5000 Har“ fixe EH IT 
点 在 第 5000 次 循环 出 现 错误 前 进入 中 断 模 式 (注意 生成 错误 的 一 种 简单 方式 是 试图 访问 一 个 不 存在 的 数组 元 
系 ， 例 如 在 一 个 有 100 4 7638 TIAAZH YH, Vile] myArray[1000]). 

(3) “只 有 在 不 执行 catch 块 的 情况 下 ， 才 执行 finally 代码 其 ”， 对 吗 ? 

(4) 下 面 定 义 了 一 个 枚 举 数 据 类 型 orientation。 编 写 一 个 应 用 程序 ， 使 用 结构 化 寞 沼 处 理 (SEH) 将 byte 类 型 
的 变量 安全 地 强制 转换 为 orientation 类 型 。 注 意 ， 可 使 用 checked 关键 字 强 制 抛 出 异 闸 ， 下 面 是 一 个 示例 。 在 
你 编写 的 应 用 程序 中 应 该 使 用 这 段 代 码 : 


enum Orientation : byte 


{ 


North = 1 
South = 2 
East = 3 
West = 4 


} 


myDirection = checked((Orientation)myByte); 
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附录 A 给 出 了 习题 答案 。 


7 4 本 章 要 点 


+ wi 


输出 调试 信息 


中 断 模式 


要 A 
编译 期 间 的 语法 错误 和 运行 期 间 的 致命 错误 都 会 使 应 用 程序 完全 失败 ， 语 义 错 误 ( 或 逻辑 错误 ) 比 较 微 妙 ， 
可 能 会 使 应 用 程序 的 执行 不 正确 ， 或 者 以 未 预料 到 的 方式 执行 
我 们 可 以 编写 代码 ,把 有 帮助 的 信息 输出 到 Output 窗口 中 , 以 帮助 在 IDE 中 进行 调试 .为 此 需要 使 用 Debug 
和 Trace 系列 函数 ， 其 中 Debug 函数 在 发 布 版 本 中 会 被 忽略 。 对 于 投入 生产 的 应 用 程序 ， 应 将 调试 输出 写 
入 日 志文 件 。 男 外 ， 还 可 以 使 用 跟 踊 后 输出 调试 信息 
可 以 通过 断 点 、 判 定语 句 ， 或 者 在 发 生 未 处 理 的 弄 第 时 ， 手 动 进入 中 断 模 式 (实际 上 就 是 暂停 应 用 程序 的 
状态 )。 可 以 在 代码 的 任意 位 置 添 加 断 点 ， 还 可 以 把 断后 配置 为 仅 在 特定 条 件 下 中 断 执 行 。 在 中 断 模式 下 ， 
可 以 检查 变量 的 内 容 (使 用 各 种 调试 信息 窗口 )， 每 次 执行 一 行 代码 ， 以 帮助 确定 哪里 出 现 了 错误 
异常 是 运行 期 间 发 生 的 错误 ， 可 以 通过 编程 方式 来 捕获 和 处 理 这 种 错误 ， 以 防 应 用 程序 终止 。 调 用 函数 
或 处 理 变量 时 ， 可 能 会 发 生 许多 不 同类 型 的 异常。 还 可 以 使 用 throw KEEFER E 
代码 中 未 处 理 的 异常 会 使 应 用 程序 终止 。 使 用 try. catch 和 finally 代码 块 处 理 异常 。try 块 标记 了 一 个 启 
用 异常 处 理 的 代码 段 ，catch 块 包含 的 代码 仅 在 异 弟 发 生 时 执行 ， 它 可 以 匹配 特定 类 型 的 寞 第 ， 还 可 以 包 
RLA catch 块 。finally 块 指定 异 沼 处 理 完 毕 后 执行 的 代码 ， 如 果 没 有 发 生 寞 剃 ，finally 块 就 指定 在 try 块 执 
行 完 毕 后 执行 的 代码 。 只 能 包含 一 个 finally 块 ， 如 果 包 含 了 catch 块 ，finally 块 就 是 可 选 的 


- 
E a) HY Be a tE Tel ST 


KEAN: 

e 理解 面 同 对 象 编程 

e {EH OOP 技术 

e FLA REAP xt OOP 的 依赖 关系 


本 章 源 代码 可 以 通过 本 书 合 作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter08 文件 夹 中 并 已 根据 本 章 示 例 的 名 称 
单独 命名 


本 书 前 面 介 绍 了 C# 语 法 和 编程 的 所 有 基础 知识 ， 以 及 调试 应 用 程序 的 方法 。 现 在 我 们 已 经 可 以 编写 出 可 供 
使 用 的 控制 台 应 用 程序 了 。 但 是 ， 要 了 解 C# 语 言 和 .NET Framework 的 强大 功能 ， 还 需要 使 用 面 同 对 象 编程 
(Object-Oriented Programming，QOOP) 技 术 。 实 际 上 ， 前 面 已 经 使 用 过 这 些 搁 术 ， 但 为 了 使 学 习 任务 简单 一 些 ， 
在 给 出 代码 示例 时 没有 重点 讲述 该 技术 。 

本 章 先 不 考虑 代码 ， 而 主要 探讨 OOP 的 基本 原理 。OOP 会 很 快 把 我 们 领 回 CHES. AW CHES 5 OOP 
是 一 种 共生 关系 。 本 章 介 绍 的 所 有 概念 在 后 续 和 章节 中 都 会 再 次 讨论 ， 并 用 汗 示 性 的 代码 来 说 明 。 所 以 ， 如 果 你 
TESR — XI] BEA RISE CH SEE PIU PARS APP 

本 章 自 先 介 绍 OOP 的 基础 知识 ， 包 括 回 答 最 基本 的 问题 “什么 是 对 象 ? ”。 很 快 你 就 会 发 现 许多 OOP R 
语 在 一 开始 很 难 理解 ， 但 本 章 提 供 了 大 量 的 解释 。 使 用 OOP 需要 以 另 一 种 方式 来 看 待 编程 。 

除了 讨论 OOP 的 一 般 原 理 外 ， 本 草 还 将 进入 一 个 需要 深刻 理解 OOP 的 领域 : 时 面 应 用 程序 。 此 类 应 用 程 
厅 依 赖 Windows 环境 ， 使 用 诸如 某 单 、 按 钮 等 特性 ， 有 许多 值得 摘 述 的 地 方 ， 在 Windows 环境 中 可 以 有 效 地 
说 明 OOP 要 点 。 


8.1 面向 对 象 编程 的 含义 


面 回 对 象 编程 解决 了 传统 编程 技巧 的 许多 问题 。 前 面 介 绍 的 编程 方法 称 为 过 程 化 编程 (Procedural 
Programming)， 第 会 导致 所 谓 的 单一 应 用 程序 ， 即 所 有 功能 痢 包 含 在 几 个 代码 模块 (种 帝 是 一 个 代码 模块 ) 中 。 而 
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使 用 OOP BUR, OB RS SERERE S SR, Rae ene. MAH, BMRB, ARS 
其 他 模块 完全 独立 。 这 种 模块 化 编程 方法 提供 了 非常 丰富 的 多 样 性 ， 大 大 增加 了 重用 代码 的 机 会 。 

为 进一步 说 明 这 个 问题 ， 把 计算 机 上 的 一 个 高 性 能 应 用 程序 想象 成 一 辆 一 流 赛车 。 如 果 使 用 传统 的 编程 技 
巧 ， 这 辆 磺 车 就 是 一 个 单元 。 如 果 要 改进 这 辆 车 ， 束 必须 蔡 换 整 车 ， 把 它 送 回 三 商 那里 ， 让 汽车 专家 升级 它 ， 


或 者 购买 一 辆 新 车 。 如 果 使 用 OOP 技术 ， 融 只 需要 从 三 商 处 购买 新 引擎， 目 己 按照 其 说 明 蔡 换 它 ， 而 不 必用 钢 
WREE. 


在 传统 应 用 程序 中 ， 执 行 流 常 是 简单 的 、 线 性 的 。 把 应 用 程序 加 载 到 内 存 中 ， 从 A AFAT, TEB nid 
束 ， 然 后 从 内 存 中 字 载 ， 在 这 个 过 程 中 可 能 用 到 其 他 各 种 实体 ， 例 如 在 存储 介质 上 的 文件 或 显卡 的 功能 ， 但 处 
理 的 主体 总 是 位 于 一 个 地 方 。 用 到 的 代码 一 般 与 使 用 各 种 数学 和 逻辑 方式 处 理 数 据 相 关 。 处 理 方 法 通 钊 比较 简 
时 ,使 用 基本 的 数据 类 型 (例如 整 型 和 布尔 值 ) 建 立 比 较 复 杂 的 数据 表达 方式 。 

而 使 用 OOP， 事 情 就 不 是 这 么 直接 了 。 尽 官 可 以 获得 相同 的 效果 ， 但 其 实现 方式 是 完全 不同 的 。OOP 技术 
以 结构 、 数 据 的 含义 以 及 数据 和 数据 之 间 的 交互 操作 为 基础 。 这 通 第 童 味 看 要 把 更 多 精力 放 在 项 目的 设计 阶段 ， 
其 好 处 是 项 目的 可 扩展 性 比较 高 。 一 旦 对 菏 种 关 型 的 数据 的 表达 方式 达成 一 致 ， 这 种 表达 方 却 融 会 应 用 到 应 用 
程序 以 后 的 版 本 中 ， 其 至 是 全 新 的 应 用 程序 中 。 这 种 一 致 的 表达 方式 可 以 极 大 地 颖 短 开 友 时 间 。 这 就 是 上 述 守 
车 示例 的 工作 原理 。 这 里 的 一 致 是 指 “ 引擎 ”的 代码 是 结构 化 的 , 这 样 束 可 以 很 容易 地 蔡 换 成 新 代码 ( 即 新 引擎 )， 
而 不 需要 找 厂 了 商 帮 忙 。 这 也 表示 ， 引 擎 创建 出 来 后 可 用 于 其 他 目的 ， 可 以 把 它 安装 到 为 一 辆 车 上 ， 或 者 用 它 驱 

除了 数据 表达 方式 的 一 致 性 外 ，OOP 编程 还 党 可 以 简化 任务 ， 因 为 较 抽 象 实体 的 结构 和 用 法 也 是 一 致 的 。 
例如 ， 不 仅 把 输出 结果 发 送 给 设备 (如 打印 机 ) 所 使 用 的 数据 格式 是 一 致 的 ， 而 且 与 该 设备 交换 数据 的 方法 也 是 
一 致 的 ， 这 包括 它 理解 的 指令 等 。 回 到 赛车 示例 上 ， 要 达成 的 一 致 做 法 包括 引擎 如 何 连接 到 油箱 ， 如 何 把 驱动 
力 传送 给 车 轮 等 。 

顾名思义 ，OOP 技术 要 使 用 对 象 。 


8.1.1 对 象 的 含义 


对 象 束 是 OOP 应 用 程序 的 一 个 构件 (building block)。 这 个 构件 封 疙 了 部 分 应 用 程序 ， 这 部 分 程 厅 可 以 是 一 
个 过 程 、 一 些 数据 或 一 些 更 抽象 的 实体 。 

简单 地 说 ， 对 象 非常 类 似 于 本 书 前 和 面 讨论 的 结构 类 型 ， 包 含 变 量 成 员 和 函数 类 型 。 它 所 包含 的 变量 组 成 了 
存储 在 对 象 中 的 数据 ， 其 中 包含 的 图 数 可 以 访问 对 象 的 功能 。 稍 微 复杂 的 对 象 可 能 不 包含 任何 数据 ， 而 只 包 
售 图 数 ， 表 示 一 个 过 程 。 例 如 ， 可 以 使 用 表示 打印 机 的 对 象 ， 其 中 的 图 数 可 以 控制 打印 机 (允许 打印 文档 、 测 试 

C# 中 的 对 象 是 从 类 型 中 创建 的 ， 就 像 前 面 的 变量 一 样 。 对 象 的 类 型 在 OOP 中 有 一 个 特殊 名 称 : 类 。 可 以 使 
用 类 的 定义 来 实例 化 对 象 ， 这 表示 创建 该 类 的 一 个 命名 实例 。“ 类 的 实例 ”和 对 象 的 含义 相同 , 但 “类 ”和 “对 
象 ”是 完全 不 同 的 概念 。 


注意 : 

术语 “类 ”和 “对 象 ” 常 常 混 淆 ， 从 一 开始 就 正确 区 分 它们 是 非常 重要 的 ， 使 用 前 面 的 赛车 示例 有 助 于 区 
分 这 两 个 术语 。 在 这 个 示例 中 ， 类 是 指 汽车 的 模板 ， 或 者 用 于 构建 汽车 的 规划 。 汽 车 本 身 是 这 些 规划 的 实例 ， 
所 以 可 以 看 成 对 象 。 


本 章 将 使 用 统一 建 模 语 言 (Unified Modeling Language，UML) 语 法 研究 类 和 对 象 。UML 是 为 应 用 程序 建 模 
而 设计 的 ， 从 组 成 应 用 程序 的 对 象 ， 到 它们 执行 的 操作 ， 再 到 我 们 希望 有 的 用 例 ， 应 有 尺 有 。 这 里 只 使 用 这 门 
语言 的 基本 部 分 ， 在 使 用 它们 的 过 程 中 进行 解释 ,但 不 考虑 比较 复杂 的 部 分 ， 因 为 UML 是 一 个 很 专业 的 主题 ， 
有 很 多 图 书 专 门 介绍 它 。 

图 8-1 是 打印 机 类 Printer 的 UML 表示 方法 。 类 名 显示 在 这 个 框 的 项 部 (后 面 将 论述 下 面 两 个 区 域 )。 
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图 8-2 是 这 个 Printer 类 的 一 个 实例 myPrinter 的 UML 表示 方法 。 


myPrinter : Printer 


图 8-1 图 82 

在 顶部 ， 首 先 显示 实例 名 ， 其 后 是 类 名 。 这 两 个 名 称 用 一 个 冒号 分 隔 。 

1. 属性 和 字段 

可 以 通过 属性 和 字段 访问 对 象 中 包含 的 数据 。 这 些 对 象 数据 可 以 用 于 区 分 不 同 的 对 象 ， 因 为 同一 个 类 的 不 
同 对 象 在 属性 和 字段 中 存储 了 不 同 的 值 。 

包含 在 对 象 中 的 不 同 数据 构成 了 对 象 的 状态 。 假 定 一 个 对 象 类 表示 一 杯 咖 啡 ， 称 为 CupOfCoffee。 在 实例 
化 这 个 类 ( 即 创建 这 个 类 的 对 象 ) 时 ， 必 须 提 供 对 类 有 意义 的 状态 。 此 时 可 以 使 用 属性 和 字段 ， 让 代码 能 通过 该 
对 象 设 置 要 使 用 的 咖啡 品牌 ， 咖 啡 中 是 否 加 牛奶 或 方 糖 ， 咖 啡 是 否 即 溶 等 。 于 是 ， 给 定 的 这 杯 咖啡 对 象 就 有 了 
指定 的 状态 ， 例 如 ， 加 牛奶 和 两 块 方 糖 的 哥伦比亚 过 滤 咖 啡 。 

字段 和 属性 都 可 以 键入 ， 所 以 可 将 信息 存储 在 字段 和 属性 中 ， 作 为 string fH. int 值 等 。 但 属性 与 字段 是 不 
同 的 ， 因 为 属性 不 提供 对 数据 的 直接 访问 。 对 象 能 让 用 户 不 考虑 数据 的 细节 ， 不 需要 在 属性 中 用 一 对 一 的 方式 
表示 。 如 果 在 CupOfCoffee 实例 中 使 用 一 个 字段 来 表示 方 糖 的 数量 , 用 户 就 可 以 在 该 字段 中 放置 自己 喜欢 的 值 ， 
其 取 值 范围 仅 由 存储 该 信息 的 类 型 来 限制 。 例 如 , 如 果 使 用 int 来 存储 这 个 数据 , 用 户 就 可 以 使 用 -2 147 483 648 
至 2147 483 647 之 间 的 任意 值 ， 如 第 3 章 所 述 。 显 然 ， 并 不 是 所 有 的 值 都 有 意义 ， 尤 其 是 负 值 ， 一 些 较 大 的 正 
值 将 需要 非常 大 的 咖啡 杯 。 但 如 果 使 用 一 个 属性 来 表示 ， 就 可 以 限制 这 个 值 ， 例 如 介 于 0 和 2 之 间 的 一 个 数字 。 

一 般 情况 下 ， 在 访问 状态 时 最 好 提供 属性 而 不 是 字段 ， 因 为 这 样 可 以 更 好 地 控制 各 种 行为 ， 这 个 选择 不 会 
影响 使 用 对 象 实 例 的 代码 ， 因 为 使 用 属性 和 字段 的 语法 是 相同 的 。 

对 属性 的 读 写 访问 也 可 以 由 对 象 来 明确 定义 。 某 些 属性 是 只 读 的 ， 只 能 查看 它们 的 值 ， 而 不 能 改变 它们 (至 
少 不 能 直接 改变 )。 这 常常 是 同时 读 取 几 个 状态 的 一 个 有 效 技巧 。CupOfCoffee 类 有 一 个 只 读 属性 Description, 
在 请 求 它 时 ， 就 返回 一 个 字符 串 ， 表 示 该 类 的 一 个 实例 的 状态 (例如 前 面 给 出 的 字符 串 )。 也 可 以 通过 查看 几 个 
属性 ， 把 相同 的 数据 组 合 起 来 ， 但 这 样 的 属性 可 以 节省 时 间 和 精力 。 还 可 以 有 只 写 的 属性 ， 其 操作 方式 是 类 
似 的 。 

除了 对 属性 的 读 / 写 访问 外 ， 还 可 以 为 字段 和 属性 指定 另 一 种 访问 权限 ， 称 为 可 访问 性 。 可 访问 性 确定 了 什 
么 代码 可 以 访问 这 些 成 员 , 它们 可 用 于 所 有 代码 (公共 ) 还 是 只 能 用 于 类 中 的 代码 (私有 ), 或 者 使 用 更 复杂 的 模式 
( 详 见 本 章 后 面 的 内 容 )。 常 见 的 情况 是 把 字段 设置 为 私有 ， 通 过 公共 属性 访问 它们 。 这 样 ， 类 中 的 代码 就 可 以 
直接 访问 存储 在 字段 中 的 数据 , 而 公共 属性 禁止 外 部 用 户 访问 这 些 数据 ,以 防 外 部 用 户 在 其 中 放置 无 效 的 内 容 。 
公共 成 员 是 类 公开 的 成 员 。 

要 更 清晰 地 阐明 这 个 问题 ， 可 以 把 可 访问 性 与 变量 的 作用 域 等 同 起 来 。 例 如 ， 私 有 字段 和 属性 可 以 看 成 拥 
有 它们 的 对 象 的 局 部 成 员 ， 而 公共 字段 和 属性 的 作用 域 也 包括 对 象 以 外 的 代码 。 

在 类 的 UML 表示 方法 中 ， 用 第 二 部 分 显示 属性 和 字段 ， 如 图 8-3 所 示 。 


这 是 CupOfCoffee 类 的 表示 方式 ,前 面 为 它 定 义 了 5 个 成 员 (属性 或 字段 
在 UML 中 ， 它 们 没有 区 别 )。 每 个 成 员 都 包含 下 述 信息 : n B 
e 可 访问 性 : 十 号 表示 公共 成 员 ，- 号 表示 私有 成 员 。 但 一 般 情 况 下 ， — 
本 章 的 图 中 不 显示 私有 成 员 ， 因 为 这 些 信息 是 类 内 部 的 信息 。 至 于 +Description : string 
读 / 写 访问 ， 则 不 提供 任何 信息 。 
e 成 员 名 。 


e 成 员 的 类 型 。 
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Di} 


冒号 用 于 分 隔 成 员 名 和 类 型 。 
2. 方法 


“方法 ”这 个 术语 用 于 表示 对 象 中 的 函数 。 这 些 函数 调用 的 方式 与 其 他 函数 相同 ， 使 用 返回 值 和 参数 的 方 
式 也 相同 ( 详 见 第 6 章 有 关 函 数 的 详 述 )。 

方法 用 于 访问 对 象 的 功能 。 与 字段 和 属性 一 样 ， 方 法 也 可 以 是 公共 的 或 私有 的 ， 按 照 需要 限制 外 部 代码 的 
访问 。 它 们 通常 使 用 对 象 的 状态 来 影响 它们 的 操作 ， 在 需要 时 访问 私有 成 员 ， 如 私有 字段 。 例 如 ，CupOfCoffee 
类 定义 了 一 个 方法 AddSugar0， 该 方法 对 递增 方 糖 数 提供 了 比 设置 相应 的 Sugar 属性 更 易 读 的 语法 。 

ft UML 的 类 框 中 ， 方法 显示 在 第 三 部 分 ， 如 图 8-4 所 示 。 


CupOfCoffee 
+Beanlype : string 
+Instant : bool 
+Milk : bool 


+Sugar : byte 
+Description : string 


+AddSugar(lin amount : byte) : byte 


图 8-4 


其 语法 类 似 于 字段 和 属性 ， 但 最 后 显示 的 类 型 是 返回 类 型 ， 这 一 部 分 还 显示 了 方法 的 参数 。 在 UML 中 ， 
每 个 参数 都 带 有 下 述 标识 符 之 一 : retum、in、out 或 inout。 它 们 用 于 表示 数据 流 的 方向 ， 其 中 out 和 inout KH 
对 应 于 第 6 章 讨 论 的 C# 关 键 字 out 和 ref. in 大 致 对 应 于 C# 中 不 使 用 这 两 个 关键 字 的 情形 (默认 情形 )。return 
表示 传 回调 用 方法 的 值 。 


812 ”一切 此 对 象 


本 书 一 直 在 使 用 对 象 、 属 性 和 方法 。 实 际 上 ，C# 和 NET Framework 中 的 所 有 东西 都 是 对 象 。 控 制 台 应 用 程 
序 中 的 Main0 函 数 就 是 类 的 一 个 方法 。 前 和 面 介绍 的 每 个 变量 类 型 都 是 一 个 类 。 前 和 面 使 用 的 每 个 命令 都 是 属性 或 
方法 , 例如 <Strine>.Length 和 <Srig>.IoUpper0 等 。 句 点 字符 把 对 象 实例 名 与 属性 或 方法 名 分 隔 开 来 ， 方 法 名 
后 面 的 0 把 方法 与 属性 区 分 开 来 。 

对 象 无 处 不 在 ， 使 用 它们 的 语法 通常 比较 简单 ， 至 少 到 现在 为 止 都 足够 简单 ， 这 使 我 们 可 以 集中 精力 讨论 
C# 中 一 些 比较 基础 的 方面 。 从 现在 开始 详细 介绍 对 象 。 记 住 这 里 讨论 的 概念 都 具有 深远 影响 ,它们 甚至 适用 于 简 
单 的 int 变量 。 


8.1.3 对象 的 生命 周期 


每 个 对 象 都 有 一 个 明确 定义 的 生命 周期 ， 除 了 “正在 使 用 ”的 正常 状态 之 外 ， 还 有 两 个 香 要 阶段 : 
e 构造 阶段 : 第 一 次 实例 化 一 个 对 象 时 ， 需 要 初始 化 该 对 象 。 这 个 初始 化 过 程 称 为 构造 阶段 ， 由 构造 函 


e 析 构 阶段 : 在 删除 一 个 对 象 时 ， 常 常 需要 执行 一 些 清理 工作 ， 例 如 释放 内 存 ， 这 由 析 构 函数 完成 。 
1. 构造 函数 


对 象 的 初始 化 过 程 是 目 动 完成 的 。 例 如 ， 我 们 不 需要 目 己 寻找 适 于 存储 新 对 象 的 内 存 空间 。 但 是 ， 在 初始 
化 对 象 的 过 程 中 ， 有 了 时 需要 执行 一 些 和 额外 的 工作 。 例 如 ， 需 要 初始 化 对 象 存储 的 数据 。 构 造 函 数 就 是 用 于 初始 
化 数据 的 函数 。 

所 有 的 类 定义 都 至 少 包含 一 个 构造 函数 。 在 这 些 构造 函数 中 ， 可 能 有 一 个 默认 构造 函数 ,该 冰 数 没有 参数 ， 
与 类 同名 。 类 定义 还 可 能 包含 几 个 市 有 参数 的 构造 函数 ， 称 为 非 默 认 的 构造 函数 。 代 码 可 以 使 用 它们 以 许多 方 
式 实例 化 对 象 ， 例 如 ， 给 存储 在 对 象 中 的 数据 提供 初始 值 。 
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在 CHF, H new 关键 字 来 调用 构造 函数 。 例如 ,可 用 下 面 的 方式 通过 其 默认 的 构造 函数 实例 化 一 个 
CupOfCoffee 对 象 : 


CupOfCoffee myCup = new CupOfCoffee(); 


还 可 以 用 非 默认 的 构造 函数 来 实例 化 对 象 。 例 如 ，CupOfCoffee 类 有 一 个 非 默 认 的 构造 函数 ， 它 使 用 一 个 
参数 在 切 始 化 时 设置 咖啡 豆 的 品牌 : 


CupOfCoffee myCup = new CupOfCoffee("Blue Mountain"); 


构造 函数 与 字段 、 属 性 和 方法 一 样 ， 可 以 是 公共 或 私有 的 。 在 类 外 部 的 代码 不 能 使 用 私有 构造 函数 实例 化 
对 象 ， 而 必须 使 用 公共 构造 图 数 。 这 样 ， 通 过 把 默认 构造 函数 设置 为 私有 的 ， 融 可 以 强制 类 的 用 户 使 用 非 默认 
的 构造 图 数 。 

一 些 类 没有 公共 的 构造 畏 数 ， 这 表明 外 部 的 代码 不 可 能 实例 化 它们 ， 这 些 类 称 为 不 可 创建 的 类 ， 但 如 稍 后 
所 述 ， 这 些 类 并 不 是 完全 没有 用 的 。 

2. 析 构 函数 

NET Framework 使 用 析 构 函数 来 清理 对 象 。 一 般 情 况 下 ,不 需要 提供 析 构 函数 的 代码 ， 而 由 默认 的 析 构 函 
数目 动 执行 操作 。 但 是 ， 如 果 在 删除 对 象 实例 前 需要 完成 一 些 重 要 操作 ， 就 应 提供 具体 的 析 构 函数 。 

例如 , 如 果 变 量 超出 了 作用 域 , 代码 就 不 能 访问 它 , 但 该 变量 仍 存 在 于 计算 机 内 存 的 某 个 地 方 。 只 有 在 .NET 
运行 程序 执行 其 垃圾 回收 ， 进 行 清理 时 ， 该 实例 才 被 彻底 删除 。 


8.1.4 静态 成 员 和 实例 类 成 员 


属性 、 方法 和 字段 等 成 员 是 对 象 实例 所 特有 的 ,此 外 ， 还 有 静态 成 员 (也 称 为 共享 成 员 ， 尤其 是 Visual Basic 
用 户 常 使 用 这 个 术语 )， 例 如 静态 方法 、 静 态 属性 或 静态 字段 。 静态 成 员 可 以 在 类 的 实例 之 间 共 享 ， 所 以 可 将 它 
们 看 成 类 的 全 局 对 象 。 静 态 属性 和 静态 字段 可 以 访问 独立 于 任何 对 象 实例 的 数据 ， 静 态 方法 可 以 执行 与 对 象 类 
型 相关 但 与 对 象 实例 无 关 的 命令 。 在 使 用 静态 成 员 时 ， 其 至 不 需要 
实例 化 对 象 。 

例如 ， 前 面 使 用 的 Console. WriteLine0 和 Convert. Tostring0 方 法 就 


是 静态 的 , 根本 不 需要 实例 化 Console 或 Convert 类 (如 果 试 看 进行 这 样 : deeds ou UR 

的 实例 化 , 操作 会 失败 ， 因 为 这 些 类 的 构造 函数 不 是 可 公共 可 访问 的 ， mM 

如 前 所 述 )。 +InstanceMethod() : void 
许多 情况 下 ,静态 属性 和 静态 方法 有 很 好 的 效果 。 例 如 ， 可 以 使 用 — 


静态 属性 跟踪 给 类 创建 了 多 少 个 实例 。 在 UML 语法 中 ,类 的 静态 成 员 
带 有 下 画 线 ， 如 图 8-5 所 示 。 

1. 静态 构造 函数 

使 用 类 中 的 静态 成 员 时 ， 需 要 预先 初始 化 这 些 成 员 。 在 声明 时 ， 可 以 给 静态 成 员 提供 一 个 初始 值 ， 但 有 时 
需要 执行 更 复杂 的 初始 化 操作 ， 或 者 在 赋值 、 执 行 静态 方法 之 前 执行 某 些 操作 。 

使 用 静态 构造 函数 可 以 执行 此 类 初始 化 任务 。 一 个 类 只 能 有 一 个 静态 构造 函数 ， 该 构造 函数 不 能 有 访问 修 
饰 符 ， 也 不 能 带 任何 参数 。 静 态 构造 函数 不 能 直接 调用 ， 只 能 在 下 述 情况 下 执行 ; 

。 创建 包含 静态 构造 函数 的 类 实例 时 

。 访问 包含 静态 构造 函数 的 类 的 静态 成 员 时 

这 两 种 情况 下 ， 会 首先 调用 静态 构造 函数 ， 之 后 实例 化 类 或 访问 静态 成 员 。 无 论 创建 了 多 少 个 类 实例 ， 其 
静态 构造 函数 都 只 调用 一 次 。 为 了 区 分 静态 构造 函数 和 本 章 前 面 介绍 的 构造 函数 ， 也 将 所 有 非 静态 构造 函数 称 
为 实例 构造 函数 。 
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2. 静态 类 

我 们 常常 希望 类 只 包含 静态 成 员 ， 且 不 能 用 于 实例 化 对 象 (如 Console)。 为 此 ， 一 种 简单 的 方法 是 使 用 静态 类 ， 
而 不 是 把 类 的 构造 函数 设置 为 私有 。 静 态 类 只 能 包含 静态 成 员 ， 不 能 包含 实例 构造 函数 ， 因 为 按照 定义 ， 它 根本 不 
能 被 实例 化 。 但 静态 类 可 以 有 一 个 静态 构造 函数 ， 如 上 一 节 所 述 。 


注意 : 
如 果 以 前 完全 没有 接触 过 OOP， 在 阅读 本 章 的 其 他 内 容 之 前 ， 应 该 停 下 来 将 OOP 研究 一 番 。 在 学 习 更 复 
杂 的 OOP 内 容 之 前 ， 全 面 掌 握 基 础 知识 是 很 重要 的 。 


8.2 OOP 技术 


前 面 介绍 了 一 些 基 础 知识 ， 知 道 对 象 是 什么 ， 以 及 对 象 的 工作 原理 ， 下 面 讨论 对 象 的 其 他 一 些 特性 ， 包括: 
接口 

继承 

多 态 性 

对 象 之 间 的 关系 

运算 符 重 载 

事件 

引用 类 型 和 值 类 型 


8.2.1 接口 


接口 是 把 公共 实例 ( 非 静 态 ) 方 法 和 属性 组 合 起 来 ， 以 封装 特定 功能 的 一 个 集合 。 一 旦 定义 了 接口 ， 就 可 以 
在 类 中 实现 它 。 这 样 ， 关 束 可 以 文 持 接口 所 指定 的 所 有 属性 和 成 员 。 

注意 ， 接 口 不 能 单独 存在 。 不 能 像 实例 化 一 个 类 那样 实例 化 接口 。 男 外 ， 接 口 不 能 包含 实现 其 成 员 的 任何 
代码 ， 而 只 能 定义 成 员 本 身 。 实 现 过 程 必 须 在 实现 接口 的 类 中 完成 。 

在 前 面 的 咖啡 示例 中 ， 可 以 把 通用 的 属性 和 方法 ， 例 如 AddSugar(). Milk, Sugar 和 Instant 组 合 到 一 个 接 
口中 ， 这 个 接口 可 以 命名 为 HotDrink( 接 口 名 一 般 以 大 写字 母 I 开 头 )。 然 后 束 可 以 在 其 他 对 象 上 使 用 该 接口 ， 
例如 CupOfTea 类 的 对 象 。 所 以 可 以 采用 类 似 方式 处 理 这 些 对 象 ， 而 对 象 仍 保留 目 己 的 属性 (例如 CupOfCoffee 
仍 有 属性 BeanType, CupOfTea 仍 有 属性 LeafType)。 

在 UML 中 ， 在 对 象 上 实现 的 接口 用 “ 棒 棒 糖 ” 语 法 来 表示 。 在 图 8-6 中 ， 采 用 与 类 相似 的 语法 把 IHotDrink 
的 成 员 放 在 一 个 单独 的 框 中 。 


CupOfCoffee IHotDrink 
«Interface» 
IHotDrink *Beanlype : string 
-Milk : bool 


Sugar : byte 


* Description : stri | 
eee CupOfTea IHotDrink 
+AddSugar(in amount : byte) : byte 
+LeatType : string 


图 8-6 
一 个 类 可 支持 多 个 接口 , 多 个 类 也 可 支持 相同 的 接口 。 所 以 接口 的 概念 让 用 户 和 其 他 开发 人 员 更 容易 理解 
其 他 人 的 代码 。 例 如 ， 有 一 些 代 码 使 用 一 个 带 某 接口 的 对 象 。 假 定 不 使 用 这 个 对 象 的 其 他 属性 和 方法 ， 就 可 以 
用 另 一 个 对 象 蔡 代 这 个 对 象 (例如 ， 使 用 上 述 IHotDrink 接口 的 代码 可 以 处 理 CupOfCoffee 和 CupOfTea 实例 )。 


第 8 章 ”面向 对 象 编程 简介 | 127 


另外 ， 该 对 象 的 开发 人 员 可 以 提供 该 对 象 的 更 新 版 本 ， 只 要 它 支 持 已 经 在 用 的 接口 ， 就 可 以 在 代码 中 使 用 这 
个 新 版 本 。 

发 布 接口 后 ， 即 接口 可 以 用 于 其 他 开发 人 员 或 终端 用 户 后 ， 最 好 不 要 修改 它 。 理 解 这 一 点 的 一 种 方式 是 把 按 
口 看 成 类 的 创建 者 和 使 用 者 之 间 的 协定 ， 即 “每 个 支持 接口 X 的 类 都 支持 这 些 方法 和 属性 ” 如 果 以 后 修改 了 接 
口 ， 也 许 是 升级 了 底层 的 代码 ， 该 接口 的 使 用 者 就 不 能 正确 运行 接口 ， 甚 至 失败 。 所 以 ， 我 们 应 做 的 是 创建 一 个 
新 接口 ， 使 其 扩展 旧 接 口 ， 可 能 还 包含 一 个 版 本 号 ， 如 X2。 这 是 创建 接口 的 标准 方式 ， 以 后 我 们 会 常 遇 到 已 编号 
的 接口 。 


可 删除 的 对 象 

IDisposable 接口 特别 有 趣 。 文 持 IDisposable 接口 的 对 象 必 须 实 现 Dispose0 方 法 ， 即 它们 必须 提供 这 个 方法 
的 代码 。 当 不 再 需要 茶 个 对 象 (例如 ， 在 对 象 超出 作用 域 之 前 ) 时 ， 束 调用 这 个 方法 ， 释 放 重 要 资源 ， 人 否则 ， 等 
到 对 垃圾 回收 调用 析 构 方法 时 才 会 释放 该 资源 。 这 样 可 以 更 好 地 控制 对 象 所 用 的 资源 。 

C# 人 允许 使 用 一 种 可 以 优化 使 用 这 个 方法 的 结构 。using 关键 字 可 在 代码 块 中 初始 化 使 用 重要 资源 的 对 象 ， 
在 这 个 代码 块 的 末尾 会 日 动 调用 Dispose0 方 法 ， 用 法 如 下 : 

<ClassName> <VariableName> = new <ClassName>(); 


using (<VariableName>) 


{ 
_ 
或 者 可 以 初始 化 对 象 <VariableName>=， 作 为 using 语句 的 一 部 分 : 


using (<ClassName> <VariableName> = new «ClassName-()) 


{ 

pn 

这 两 种 情况 下 ， 可 在 using (ABR RHEE <VariableName>, FTE SER AK Fé A A RCE FREUT 
完毕 后 ， 调 用 Dispose()). 


8.2.2 继承 


继承 是 OOP 最 午 要 的 特性 之 一 。 任 何 类 痢 可 以 从 男 一 个 类 继承 ， 这 就 是 说 ， 这 个 类 拥有 它 继 承 的 类 的 所 有 
JA. f£ OOP 中 ， 被 继承 (也 称 为 派生 ) 的 类 称 为 父 类 (也 称 为 基 类 )。 注 意 ，C# 中 的 对 象 仅 能 直接 派生 于 一 个 基 
类 ， 当 然 基 类 也 可 以 有 自己 的 基 类 。 

继承 性 可 从 一 个 较 一 般 的 基 类 扩展 或 创建 更 多 的 特定 类 。 例 如 ， 考 虑 一 个 代表 农场 家 冀 的 类 (由 80 多 岁 的 
资深 开发 人 员 MacDonald 在 他 的 家 冀 应 用 程序 中 使 用 )。 这 个 类 名 为 Animal， 拥 有 EatFood0 或 Breed()55 77 14, 
我 们 可 以 创建 一 个 派生 类 Cow; Cow 文 持 所 有 这 些 方法 ， 也 有 目 己 的 方法 ， 如 Moo0 和 SupplyMilkO。 还 可 以 
创建 男 一 个 派生 类 Chicken， 该 类 有 Cluck0 和 LayEgg0 方 法 。 

在 UML 中 ， 用 和 荫 头 表示 继 水 ， 如 图 8-7 所 示 。 


a 


+EatFood|) 
+Breed() 
‘i 


Cow 
+Cluck() *Moof) 
+LayEgg() +SupplyMilk() 
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注意 : 


为 简洁 起 见 ， 图 8-7 中 省 略 了 成 员 的 返回 类 型 。 


在 继承 一 个 基 类 时 ， 成 员 的 可 访问 性 就 成 了 一 个 重要 问题 。 派 生 类 不 能 访问 基 类 的 私有 成 员 ， 但 可 以 访问 
其 公共 成 员 。 不 过 ， 派 生 类 和 外 部 的 代码 都 可 以 访问 公共 成 员 。 这 就 是 说 ， 只 使 用 这 两 个 级 别 的 可 访问 性 ， 不 
能 让 一 个 成 员 可 由 基 类 和 派生 类 访问 ， 而 不 能 由 外 部 的 代码 访问 。 

为 解决 这 个 问题 ，C# 提 供 了 第 三 种 可 访问 性 : protected， 只 有 派生 类 才能 访问 protected 成 员 。 对 于 外 部 代 
码 来 说 ， 这 个 可 访问 性 与 私有 成 员 一 样 : 外 部 代码 不 能 访问 private 成 员 和 protected 成 员 。 

除了 定义 成 员 的 保护 级 别 外 ， 我 们 还 可 以 为 成 员 定 义 其 继承 行为 。 基 类 的 成 员 可 以 是 虚拟 的 ， 也 就 是 说 ， 
成 员 可 以 由 继承 它 的 类 重 写 。 派 生 类 可 以 提供 成 员 的 男 一 种 实现 代码 。 这 种 实现 代码 不 会 删除 原来 的 代码 ， 仍 
可 以 在 类 中 访问 原来 的 代码 ， 但 外 部 代码 不 能 访问 它们 。 如 果 没 有 提供 其 他 实现 方式 ， 通 过 派生 类 使 用 成 员 的 
外 部 代码 就 日 动 访问 基 类 中 成 员 的 实现 代码 。 


注意 : 


在 UML 中 ， 公 共 成 员 用 + 上 表示 ， 其 他 成 员 用 - (私有 成 员 )、#( 受 保护 的 成 员 ) 和 斜体 (虚拟 成 员 ) 表 示 。 


注意 : 
虚拟 成 员 不 能 是 私有 成 员 ， 因 为 这 样 会 自 相 矛盾 一 一 不 能 既 要 求 派 生 类 重 写 成 员 ， 又 不 让 派生 类 访问 该 
成 员 。 


在 前 面 的 家 冀 示 例 中 ， 可 将 EatFood0 变 成 虚拟 成 员 ， 在 派生 类 中 为 它 提供 新 的 实现 代码 ， 例 如 为 Cow 类 
提供 新 的 实现 代码 , 如 图 8-8 所 示 。 这 里 显示 了 Animal 和 Cow 类 的 EatFood0 方 法 , 说 明 它 们 有 自己 的 实现 代码 。 

基 类 还 可 以 定义 为 抽象 类 。 抽 象 类 不 能 直接 实例 化 。 要 使 用 抽象 类 ， 必 须 继 承 这 个 类 ， 抽 象 类 可 以 有 抽象 
成 员 ， 这 些 成 员 在 基 类 中 没有 实现 代码 ， 所 以 派生 类 必须 实现 它们 。 如 果 Animal 是 一 个 抽象 类 ，UML 就 会 
如 图 8-9 所 示 。 


EmN 
ee ENNER 
+EatFood() 


+Breed() l *Breedü — 
Minii 


A— 


NEM +Cluck) 
+Cluck() | +LayEgg() 
+LayEgg() 


+EatFood() 


+EatFood() +Breed() 


注意 : 
抽象 类 的 名 称 以 斜体 显示 (有 时 它们 的 方 框 以 虚线 显示 )。 
在 图 8-9 中 ，EatFood0 和 Breed0 都 显示 在 派生 类 Chicken 和 Cow 中 ， 这 说 明 这 些 方法 是 抽象 的 (必须 在 派 


生 类 中 重 写 ) 或 者 虚拟 的 (这 里 已 经 在 Chicken 和 Cow 中 重 写 )。 当 然 ， 抽 象 基 类 可 以 提供 成 员 的 实现 代码 ， 这 有 是 
十 分 第 见 的 。 不 能 实例 化 抽象 类 ， 并 不 意味 者 不 能 在 抽象 类 中 封 滩 功能 。 
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了 最后， 类 可 以 是 密封 (seaj) 的 。 密 封 的 类 不 能 用 作 基 类 ， 所 以 没有 派生 类 。 
在 C# 中 ， 所 有 对 象 都 有 一 个 共同 的 基 类 object( 在 .NET Framework 中 ， 它 是 System.Object 类 的 别名 )。 第 9 
草 将 话 细 介绍 这 个 类 。 


注意 : 
如 本 章 前 面 所 述 ， 接 口 也 可 以 继承 自 其 他 接口 。 与 类 不 同 的 是 ,接口 可 以 继承 多 个 基 接 口 ( 与 类 可 以 支持 多 
个 接口 的 方式 类 似 )。 


823 多 态 性 


继承 的 一 个 结果 是 派生 于 基 类 的 类 在 方法 和 属性 上 有 一 定 的 重 登 ， 因 此 ， 可 以 使 用 相同 的 语法 处 理 从 同一 
个 基 类 实例 化 的 对 象 。 例 如 ， 如 果 基 类 Animal 有 一 个 EatFood0 方 法 ， 则 在 其 派生 类 Cow 和 Chicken 中 调用 这 
个 方法 的 语法 是 类 似 的 : 

Cow myCow = new Cow(); 

Chicken myChicken = new Chicken(); 


myCow.EatFood(); 
myChicken.EatFood(); 


多 态 性 则 推进 了 一 步 。 可 以 把 东 个 小 生 关 型 的 变量 赋 给 基本 类型 的 变量 ， 例 如 : 

Animal myAnimal = myCow; 

不 需要 进行 强制 类 型 转换 ， 就 可 以 通过 这 个 变量 调用 基 类 的 方法 : 

myAnimal.EatFood(); 

结果 是 调用 派生 类 中 的 EatFood0 的 实现 代码 。 注 意 ， 不 能 以 相同 的 方式 调用 派生 类 上 定义 的 方法 。 下 面 的 
代码 无 法 运行 : 

myAnimal.Moo(); 


但 可 以 把 基本 类 型 的 变量 转换 为 派生 类 变量 ， 调 用 派生 类 的 方法 ， 如 下 所 示 : 


Cow myNewCow = (Cow)myAnimal; 
myNewCow.Moo (); 


如 果 原 始 变量 的 类 型 不 是 Cow 或 派生 于 Cow HRH, A ll TE PE PLS AP) AVES TT 
明 对 象 的 类 型 是 什么 ， 详 见 下 一 章 。 

在 派生 于 同一 个 闫 的 不 同 对 象 上 执行 任务 时 ， 多 态 性 是 一 种 极 有 效 的 技巧 ， 其 使 用 的 代码 最 少 。 注 意 并 不 
是 只 有 共有 至 同一 个 父 类 的 类 才能 利用 多 态 性 。 只 要 子 类 和 孙子 类 在 继承 层 人 次 结构 中 有 一 个 相同 的 类 ， 它 们 就 可 
以 用 同样 的 方式 利用 多 态 性 。 

还 要 注意 ， 在 C# 中 ， 所 有 类 都 派生 于 同一 个 类 object, object 是 继承 层次 结构 中 的 根 。 所 以 可 以 把 所 有 对 
象 看 成 object 类 的 实例 。 这 就 是 在 建立 字符 串 时 ，WiriteLine0 可 以 处 理 无 数 多 种 参数 组 合 的 原因 。 第 一 个 参数 
后 和 面 的 每 个 参数 部 可 以 看 成 一 个 object 实例 ， 所 以 可 以 把 任何 对 象 的 输出 结果 写 到 屏 磊 上 。 为 此 ， 需 要 调用 方 
法 ToString((object 的 一 个 成 员 )。 我 们 可 以 重 写 这 个 方法 ， 为 目 己 的 类 提供 合适 的 实现 代码 ， 或 者 使 用 默认 实 
现代 人 码 ， 返 回 类 名 (根据 它 所 在 的 名 称 空 间 ， 返 回 类 的 限定 名 称 )。 


接口 的 多 态 性 

尽管 不 能 像 对 象 那样 实例 化 接口 ， 但 可 以 建立 接口 类 型 的 变量 ， 然 后 就 可 以 在 支持 该 接口 的 对 象 上 ， 使 用 
这 个 变量 来 访问 该 接口 提供 的 方法 和 属性 . 

例如 , 假定 不 使 用 基 类 Animal 提供 的 EatFood0 方 法 , 而 是 把 该 方法 放 在 IConsume 接口 上 。 Cow 和 Chicken 
类 也 支持 这 个 接口 ， 唯 一 的 区 别 是 它们 必须 提供 EatFood( 方 法 的 实现 代码 (因为 接口 不 包含 实现 代码 )。 接 着 就 
可 以 使 用 下 述 代码 访问 该 方法 了 : 


Cow myCow = new Cow(); 
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Chicken myChicken = new Chicken(); 

IConsume consumeInterface; 

consumeInterface = myCow; 

consumeInterface.EatFood(); 

consumeInterface — myChicken; 

consumeInterface.EatFood(); 

这 就 提供 了 以 相同 方式 访问 多 个 对 象 的 简单 方式 ， 且 不 依赖 于 一 个 公共 的 基 类 。 例 如 ， 这 个 接口 可 以 由 派 
HÆF Vegetable( 而 不 是 Animal) 的 VenusFlyTrap 类 实现 : 

VenusFlyTrap myVenusFlyTrap = new VenusFlytTrap(); 

IConsume consumeInterface; 

consumeInterface = myVenusFlyTrap: 

consumeInterface.EatFood(); 


在 这 段 代 码 中 , 调用 consumeInterface.EatFood0 的 结果 是 调用 Cow. Chicken 或 VenusFlyTrap 类 的 EatFood() 
方法 ， 这 取决 于 把 哪个 实例 赋予 接口 类 型 的 变量 。 

注意 ， 派 生 类 会 继承 其 基 类 支持 的 接口 。 在 上 面 的 第 一 个 示例 中 ， 要 么 是 Animal 文 持 IConsume, BAZ 
Cow 和 Chicken 文 持 IConsume。 有 共同 基 类 的 类 不 一 定 有 共同 接口 ， 反 之 亦 然 。 


8.2.4 对 象 之 间 的 关系 


继承 是 对 象 之 间 的 一 种 简单 关系 ， 可 以 让 派生 类 完整 地 获得 基 类 的 特性 ， 而 且 派 生 类 也 可 以 访问 基 类 内 部 
的 一 些 工作 代码 (通过 受 保护 的 成 员 )。 对 象 之 间 还 具有 其 他 一 些 重要 关系 。 
本 节 简 要 讨论 下 述 关 系 : 
e 包含 关系 : 一 个 类 包含 为 一 个 类 。 这 类 似 于 继承 关系 ,但 包含 类 可 以 控制 对 被 包含 类 的 成 员 的 访问 ， 其 
至 在 使 用 被 包含 类 的 成 员 前 进行 其 他 处 理 。 
e 集合 关系 : 一 个 类 用 作 男 一 个 类 的 多 个 实例 的 容器 。 这 类 似 于 对 象 数组 ,但 集合 具有 其 他 功能 ， 包 括 索 
引 、 排 序 和 重新 设置 大 小 等 。 
1. 包含 关系 
用 一 个 成 员 字段 包含 对 象 实例 ， 就 可 以 实现 包含 (containment) 关 系 。 这 个 成 员 字 段 可 以 是 公共 字段 ， 此 时 
与 继承 关系 一 梓 ， 容 器 对 象 的 用 户 可 以 访问 它 的 方法 和 属性 ， 但 不 能 像 继 承 关 系 那 样 ， 通 过 派生 关 访 问 类 的 内 
HB. 
另外， 可 让 被 包含 的 成 员 对 象 变 成 私有 成 员 。 如 果 这 么 做 ， 用 户 就 不 能 直接 访问 任何 成 员 ， 即 使 这 些 成 员 
是 公共 的 。 但 可 以 使 用 包含 类 的 成 员 访 问 这 些 私有 成 员 。 也 就 是 说 ， 可 以 完全 控制 被 包含 的 类 对 外 提供 什么 成 
员 ( 或 者 不 提供 任何 成 员 )， 还 可 在 访问 被 包含 类 的 成 员 前 ， 


在 包含 类 的 成 员 上 执行 其 他 处 理 。 
例如 ，Cow 类 包含 一 个 Udder 类 ，Udder 类 有 一 个 公共 EE 

方法 MilkO. Cow 对 象 可 以 按照 要 求 调用 这 个 方法 ， 作 为 其 

SupplyMilkO 方 法 的 一 部 分 ， 但 Cow 对 象 的 用 户 看 不 到 这 些 

细节 ， 或 者 这 些 细节 对 Cow 对 象 的 用 户 并 不 重要 。 
ft UML 中 ， 被 包含 类 可 用 关联 线条 来 表示 。 对 于 简单 


+Moo() 
+SupplyMilk() 


包含 的 Udder 类 实例 表示 为 Cow 类 的 私有 字段 ， 如 图 8-10 图 8-10 
所 示 。 
2. 集合 关系 


包含 关系 ， 可 以 用 高 有 1 的 线条 说 明 一 对 一 的 关系 (一 个 
Cow 实例 包含 一 个 Udder 实例 )。 为 清晰 起 见 ， 也 可 以 把 被 


第 5 章 讨 论 了 如 何 使 用 数组 存储 多 个 同类 型 的 变量 ， 这 也 适用 于 对 象 (前 面 使 用 的 变量 类 型 实际 上 有 是 对 
象 )。 例 如 : 
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Animal[] animals = new Animal[5]; 


集合 基本 上 就 是 一 个 增加 了 功能 的 数组 。 集 合 以 与 其 他 对 象 相同 的 方 
式 实 现 为 类 。 它 们 通常 以 所 存储 的 对 象 名 称 的 复数 形式 来 命名 ， 例 
如 用 类 Animals 包含 Animal 对 象 的 一 个 集合 。 

数组 与 集合 的 主要 区 别 是 , SEDES LOAN DHE, 例如 Addo 
和 Remove0 方 法 可 添加 和 删除 集合 中 的 项 。 而 且 集 合 通 常 有 一 个 
Item 属性 ， 它 根据 对 象 的 索引 返回 该 对 象 。 通 常 ， 这 个 属性 还 允许 
实现 更 复杂 的 访问 方式 。 例 如 ， 可 以 设计 一 个 Animals, ib Animal 
对 象 根据 其 名 称 来 访问 。 

其 UML 表示 如 图 8-11 所 示 。 图 8-11 中 没有 包含 成 员 ， 因 为 这 
里 摘 述 的 是 关系 。 连 接线 末尾 的 数字 表示 一 个 Animals 对 象 可 以 包 
含 0 个 或 多 个 Anima 对 象 。 第 11 章 将 详细 论述 集合 。 


8.2.5 运算 符 重 载 


本 书 前 面 介绍 了 如 何 使 用 运算 符 处 理 简 单 的 变量 类 型 。 有 时 也 可 以 把 运算 符 用 于 从 类 实例 化 而 来 的 对 象 ， 
因为 类 可 以 包含 如 何人 处 理 运算 符 的 指令 。 
例如 ， 给 Animal 类 添加 一 个 新 属性 Weight。 接 看 使 用 下 述 代 码 比 较 家 冀 的 体重 : 


if (cowA.Weight > cowB.Weight) 
{ 


使 用 运算 和 从重 载 ， 可 在 代码 中 提供 隐 式 使 用 Weight 属性 的 逻辑 ， 如 下 面 的 代码 所 示 : 


if (cowA > cowB) 
{ 


} 

大 于 运算 符 > 被 重 载 了 。 我 们 为 重 载运 算 符 编写 代码 ， 执 行 上 述 操 作 ， 这 段 代 码 用 作 类 定义 的 一 部 分 ， 而 
该 运算 符 作用 于 这 个 类 。 在 上 例 中 ， 使 用 了 两 个 Cow 对 象 ， 所 以 运算 符 重 载 定义 包含 在 Cow 类 中 。 也 可 以 采 
用 相同 的 方式 重 载运 算 符 ， 使 其 处 理 不 同 的 类 ， 其 中 一 个 (或 两 个 ) 类 定义 包含 达到 这 一 目的 的 代码 。 

注意 ， 只 能 采用 这 种 方式 重 载 现 有 的 C# 运 算 符 ， 不 能 创建 新 的 运算 符 。 但 可 以 为 一 元 (一 个 操作 数 ) 和 二 元 
(两 个 操作 数 ) 运 算 符 (如 + 或 >) 提 供 实现 代码 。 相 关内 容 详 见 第 13 章 。 


8.2.6 事件 


对 象 可 以 激活 和 使 用 事件 ， 作 为 它们 处 理 的 一 部 分 。 事 件 是 非常 重要 的 ， 可 在 代码 的 其 他 部 分 起 作用 ， 类 
似 于 异常 (但 功能 更 强大 )。 例 如 ， 可 以 在 把 Animal 对 象 添加 到 Animals 集合 中 时 ， 执 行 特定 的 代码 ， 而 这 部 分 
代码 不 是 Animals 类 的 一 部 分 ， 也 不 是 调用 Add0 方 法 的 代码 的 一 部 分 。 为 此 ， 需 要 给 代码 添加 事件 处 理 程序 ， 
这 是 一 种 特殊 类 型 的 函数 ， 在 事件 发 生 时 调用 。 还 需要 配置 这 个 处 理 程序 ， 以 监听 自己 感 兴趣 的 事件 。 

使 用 事件 可 创建 事件 驱动 的 应 用 程序 ， 此 类 应 用 程序 比 读者 此 时 所 能 想到 的 多 得 多 。 例 如 ， 许 多 Windows 
应 用 程序 完全 依赖 于 事件 。 每 个 按钮 单 击 或 滚动 条 拖 动 操作 都 是 通过 事件 处 理 实现 的 ， 其 中 事件 是 通过 鼠标 或 
键盘 触发 的 。 

本 章 后 面 将 介绍 Windows 应 用 程序 中 事件 的 工作 原理 ， 第 13 章 将 深入 讨论 事件 。 


8.2.7 引用 类 型 和 值 类 型 


在 C# 中 ,数据 根据 变量 的 类 型 以 两 种 方式 中 的 一 种 存储 在 一 个 变量 中 。 变 量 的 类 型 分 为 两 种 : 引用 类 型 和 
值 类 型 ， 其 区 别 如 下 : 
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。 值 类 型 在 内 存 的 同一 处 存储 它们 自己 和 它们 的 内 容 。 

。 引用 类 型 存储 指向 内 存 中 其 他 某 个 位 置 ( 称 为 堆 ) 的 引用 ， 实 际 内 容 存储 在 这 个 位 置 。 

实际 上 ， 在 使 用 C# 时 ， 不 必 过 多 地 考虑 这 个 问题 。 到 目前 为 止 ， 所 使 用 的 string 变量 (这 是 引用 类 型 ) 与 使 
用 其 他 简单 变量 (大 多 数 是 值 类 型 ， 例 如 int) 的 方式 完全 相同 。 

值 类 型 和 引用 类 型 的 一 个 主要 区 别 是 ; 值 类 型 总 是 包含 一 个 值 ， 而 引用 类 型 可 以 是 null， 表 示 它们 不 包 合 
值 。 但 是 ， 可 使 用 可 空 类 型 创建 值 类 型 ， 使 值 类 型 在 这 个 方面 的 行为 方式 类 似 于 引用 类 型 ( 即 可 以 为 null)。 第 
12 章 在 介绍 泛 型 (包括 可 空 类 型 ) 这 一 高 级 主题 时 将 讨论 这 方面 的 内 容 。 

只 有 string 和 object 类 型 是 简单 的 引用 类 型 。 数 组 也 是 隐 式 的 引用 类 型 。 我 们 创建 的 每 个 类 都 是 引用 类 型 
这 就 是 在 这 里 强调 这 一 点 的 原因 。 


8.3 ”桌面 应 用 程序 中 的 OOP 


第 2 章 在 C# 中 使 用 Windows Presentation Foundation(WPF) 创 建 了 一 个 简单 的 昌 面 应 用 程序 。WPF 果 面 应 用 
程序 非常 依赖 OOP 技术 ， 本 节 将 论述 OOP 技术 ， 说 明 本 章 的 一 些 论 点 。 下 面 通过 一 个 简单 示例 加 以 说 明 。 


试 一 试 ” 使 用 对 象 : ChO8Ex01 


(1) 在 C:\BeginningCSharp7\Chapter08 目录 中 创建 一 个 新 的 WPF 应 用 程序 Ch08Ex01. 
(2) 使 用 Toolbox 添加 一 个 新 的 按钮 控件 ， 使 其 位 于 MainWindow 的 中 央 ， 如 图 8-12 所 示 。 


MainWindow.xaml P X 


di 


100% [fr] em | 4-| « 


Là Design t+ XAML 


图 8-12 


(3) 双击 按钮 ， 为 鼠标 单 击 事件 添加 代码 。 修 改 代 码 ， 如 下 所 示 : 
private void Button Click(object sender, RoutedEventArgs e) 
{ 
( (Button) sender) .Content = "Clicked!"; 
Button newButton = new Button(); 
newButton.Content = "New Button! "; 
newButton.Margin = new Thickness(10, 10, 200, 200); 
newButton.Click += newButton Click; 
( (Grid) ( (Button) sender) .Parent) .Children.Add(newButton) ; 
} 
private void newButton Click(object sender, RoutedEventArgs e) 
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((Button)sender).Content = "Clicked!!"; 


(4) 运行 该 应 用 程序 ， 窗 口 如 图 8-13 所 示 。 


8-13 


(5) 单 击 标记 为 Button 的 按钮 ， 显 示 内 容 将 随 之 变化 ， 如 图 8-14 所 示 。 


New Button! 


8-14 


(6) 单 击 标记 为 New Button! 的 按钮 ， 显 示 内 容 将 随 之 变化 ， 如 图 8-15 所 示 。 


Clicked! 


8-15 
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示例 说 明 

仅 添 加 几 行 代码 ， 束 创建 了 一 个 可 以 完成 系 项 任务 的 果 面 应 用 程序 。 下 面 说 明 C# 中 的 一 些 OOP 技术 。 即 
使 在 谈 到 加 面 应 用 程序 时 ,“ 一 切 泪 对象” 这 人 句 话 也 是 正确 的 。 从 运行 的 窗 体 ， 到 窗 体 上 的 控件 ， 痢 需要 使 用 
OOP 技术 。 这 个 示例 重点 说 明了 本 和 章 前 面 介 绍 的 一 些 概 念 ， 解 释 如 何 把 它们 组 合 在 一 起 。 

在 应 用 程序 中 ， 计 先 在 MainWindow 窗口 中 添加 一 个 新 按钮 ， 这 个 按钮 是 一 个 对 象 ， 它 是 Button 类 的 一 个 实 
Pil; 窗口 是 MainWindow KHK PJ, ZRA Window 类 派生 而 来 。 接 看 双击 按钮 ， 添 加 一 个 事件 处 理 程序 ， 监 
听 Button 类 提供 的 Glick 事件 。 这 个 事件 处 理 程 序 被 添加 到 封 洲 应 用 程序 的 MainWindow 对 象 代 码 中 ， 是 一 个 


私有 方法 : 
private void Button Click(object sender, RoutedEventArgs e) 
{ 
} 


这 段 代 码 使 用 C# 关 键 字 private 作为 修饰 符 。 现 在 不 要 考虑 这 个 关键 字 , 第 9 章 将 详细 解释 本 章 提 及 的 OOP 
技术 。 

我 们 添加 的 第 一 行 代码 改变 了 所 单 击 按钮 上 的 文本 。 它 利用 了 本 章 前 面 讨 论 的 多 态 性 。 表 示 按 钮 的 Button 
对 象 作为 一 个 object 参数 友 送 给 事件 处 理 程序 ,， 访 事件 处 理 程序 把 参数 强制 转换 为 Button 类 型 (这 是 可 能 的 , 因 
为 Button 对 象 继 承 于 System.Object, System.Object 是 一 个 .NET 2$, object 是 其 别名 )。 然 后 修改 对 象 的 Content 
属性 ， 改 变 显示 的 文本 : 


í (Button) sender) .Content = "Clicked!"; 


接着 用 new 关键 字 创 建 一 个 新 的 Button 对 象 (注意 在 这 个 项 目 中 设置 了 名 称 空间 ， 因 此 可 以 使 用 这 个 简单 
的 语法 ， 人 否则 残 需 要 使 用 这 个 对 象 的 完整 限定 名 System. Windows.Controls.Button): 


Button newButton = new Button(); 


还 可 以 将 新 建 的 Button 对 象 的 Content 和 Margin 属性 设置 为 合适 的 值 ， 使 按钮 显示 在 合适 的 地 方 。 注 意 ， 
Margin 属性 的 类 型 是 Thickness, AEH FRAR AAE —]- Thickness 对 象 ， 然 后 将 其 赋值 给 Margin 
属性 : 


newButton.Content = "New Button!"; 
newButton.Margin = new Thickness(10, 10, 200, 200); 


在 代码 的 其 他 地 方 添 加 一 个 新 的 事件 处 理 程序 ， 以 啊 应 新 按钮 生成 的 Click 事件 : 
private void newButton Click(object sender, RoutedEventArgs e) 
((Button) sender) .Content = "Clicked! !"; 

接 独 使 用 重 载运 复 符 语法 ， 把 这 个 事件 处 理 程序 注册 为 Click 事件 的 监听 程序 : 


newButton.Click += newButton Click; 


最 后 ， 把 新 按钮 添加 到 窗口 中 。 为 此 ， 使 用 已 有 按钮 的 Parent 属性 找 出 其 父 对 象 , 将 其 转换 为 正确 的 类 型 ， 
HU Grid。 然 后 ， 通 过 将 新 按钮 作为 参数 传递 给 Grid.Children 属性 的 Add0 方 法 ， 将 该 按钮 添加 到 窗口 中 : 
( (Grid) ( (Button) sender) .Parent) .Children.Add(newButton) ; 
这 些 代 码 实 际 上 没有 看 起 来 那样 复杂 。 一 旦 理解 了 WPF 是 通过 一 个 控件 (包括 按钮 和 容器 ) 的 层次 结构 来 显 
示 窗 口 的 内 容 ， 使 用 这 类 代码 就 显得 再 目 然 不 过 了 。 
这 个 简短 示例 几乎 使 用 了 本 音 介 绍 的 所 有 技术 。 可 以 看 出 ，OOP 编程 并 不 复杂 一 一 只 需要 从 男 一 个 角度 来 
看 竺 编程 即 可 。 
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8.4 习题 


(1) 下 述 哪些 项 在 OOP 中 有 真实 级 别 的 可 访问 性 ? 
a. AJL 
b. 公共 
c. 安生 
d 私有 
e. 受 保 护 的 
f 松散 的 
g. 通配符 
(2) “必须 手动 调用 对 象 的 析 构 函数 ， 人 否则 就 会 良 费 内 存 ” 的 说 法 正确 吗 ? 
(3) 在 调用 类 的 静态 方法 时 ， 需 要 创建 该 类 的 对 象 吗 ? 
(4) 为 下 述 类 和 接口 绘制 一 个 类 似 于 本 章 介 绍 的 UML B: 
e 抽象 类 HotDrink， 它 具有 方法 Drink、AddMilk 和 AddSugar， 以 及 属性 Milk 和 Sugar. 
e 接口 ICcup， 它 具有 方法 Refill 和 Wash， 以 及 属性 Color 和 Volume. 
e 派生 于 HotDrink 的 类 CupOfCoffee 文 持 ICup 接口 ， 还 有 一 个 属性 BeanType。 
e 派生 于 HotDrink 的 类 CupOfTea X ff ICup 接口 ， 还 有 一 个 属性 LeafType。 
(5) 为 一 个 函数 编写 一 些 人 代码， 接受 上 述 示例 的 两 个 杯子 对 象 中 的 任意 一 个 作为 参数 。 该 图 数 应 该 为 传递 
给 它 的 任何 杯子 对 象 调用 AddMilk, Drink 和 Wash 方法 。 
附录 A 给 出 了 习题 答案 。 
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E m 要 A 
对 象 是 OOP 应 用 程序 的 组 成 部 件 。 类 是 用 于 实例 化 对 象 的 类 型 定义 。 对 象 可 以 包含 数据 ， 提 供 其 他 代 
码 可 以 使 用 的 操作 。 数 据 可 以 通过 属性 供 外 部 代码 使 用 ， 操 作 可 以 通过 方法 供 外 部 代码 使 用 。 属 性 和 方 


对 象 和 类 
法 都 称 为 类 的 成 员 。 属 性 可 以 进行 读 取 访问 、 写 入 访问 或 读 写 访问 。 类 成 员 可 以 是 公共 的 (可 用 于 所 有 代 
码 ) 或 私有 的 (只 有 类 定义 中 的 代码 可 以 使 用 )。 在 .NET 中 ， 一 切 都 是 对 象 
^ à 过 i 用 它 的 一 Ji K: : Pl Hie MH : D E . z AT t) ]ER X , 上 ue ey X 
对 象 的 生命 周期 对 象 通过 调用 它 的 一 个 构造 函数 来 实例 化 。 不 再 需要 对 和 象 时 ， 就 执行 其 析 构 函数 ， 以 删除 它 。 要 清理 对 


SR, iun mid LAMPS 
静态 成 员 和 实例 成 员 | 实例 成 员 只 能 在 类 的 对 象 实 例 上 使 用 ， 静 态 成 员 只 能 直接 通过 类 定义 使 用 ， 它 不 与 实例 关联 
接口 是 可 以 在 类 上 实现 的 公共 属性 和 方法 的 集合 。 可 将 实现 了 一 个 接口 的 类 的 对 象 赋值 给 对 应 实例 类 型 
的 变量 。 之 后 通过 该 变量 ， 可 以 使 用 该 接口 定义 的 成 员 
继承 是 一 个 类 定义 派生 于 男 一 个 类 定义 的 机 制 。 类 从 其 父 类 中 继承 成 员 ， 每 个 类 都 只 能 有 一 个 父 类 。 子 
类 不 能 访问 父 类 的 私有 成 员 ， 但 可 以 定义 受 保护 的 成 员 ， 受 保护 的 成 员 只 能 在 该 类 和 派生 于 该 类 的 子 类 
中 使 用 。 子 类 可 以 重 写 父 类 中 的 虚拟 成 员 。 所 有 的 类 都 有 一 个 以 System.Object 结尾 的 继承 链 ， TE C# 中 ， 
System.Object 有 一 个 别名 object 
多 态 性 从 一 个 派生 类 实例 化 的 所 有 对 象 都 可 以 看 成 其 父 类 的 实例 
对 象 可 以 包含 其 他 对 象 ， 也 可 以 表示 其 他 对 象 的 集合 。 要 在 表达 式 中 处 理 对 象 ， 常 常 需要 通过 运算 符 重 
对 象 天 系 和 特性 载 ， 定 义 运算 符 如 何 处 理 对 象 。 对 象 可 以 提供 事件 ， 事 件 因 菏 种 内 部 处 理 而 被 触发 ， 客 户 端 代码 通过 提 
供 事件 处 理 程序 来 啊 应 事件 
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本 章 内 容 : 


结构 类 型 的 更 多 内 容 
复制 对 象 的 一 些 重要 信息 


e 如 何在 C# 中 定义 类 和 接口 

e 用 来 控制 可 访问 性 和 继承 的 关键 字 的 用 法 

e System.Object 类 及 其 在 类 定义 中 的 作用 

e 如何 使 用 Visual Studio 提供 的 一 些 帮 助 工具 
e 如 何 定义 类 库 

e 接口 和 抽象 类 的 异同 

* 

* 


本 草 源 代码 下 载 : 

本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.con/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapter09 文件 夹 中 并 已 根据 本 章 示例 的 名 称 
单独 命名 。 

第 8 章 介 绍 了 面 回 对 象 编程 (OOP) 的 特性 ， 本 章 将 理论 付 诸 实践 ， 看 看 如 何在 C# 中 定义 类 。 本 章 并 不 讨论 
如 何 定义 类 的 成 员 ， 而 重点 讨论 如 何 定义 类 本 刁 。 

自 先 分 析 基 本 的 类 定义 语法 、 用 于 确定 类 可 访问 性 的 关键 字 以 及 指定 继承 的 方式 。 我 们 还 将 介绍 接口 的 定 
义 ， 因 为 它们 在 许多 方面 都 类 似 于 类 的 定义 。 

本 章 的 其 他 部 分 介绍 在 C# 中 定义 类 时 涉及 的 各 种 相关 主题 。 


9.1 C# 中 的 类 定义 
C# 使 用 class 关键 字 来 定义 类 : 
class MyClass 


{ 


// Class members. 


这 段 代码 定义 了 一 个 类 MyClass. HEM f — T 2SJni» Son] AED "P BE UI In] E HY I: EDS ASSET 
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实例 化 。 上 默认 情况 下 ， 类 声明 为 内 部 的 ， 即 只 有 当前 项 目 中 的 代码 才能 访问 它 。 可 使 用 internal 访问 修饰 符 关 
键 字 来 显 式 地 指定 这 一 点 ， 如 下 所 示 ( 但 这 没有 必要 ): 
internal class MyClass 


// Class members. 


男 外 ， 还 可 以 指定 类 是 公共 的 ， 可 被 其 他 项 目 中 的 代码 访问 。 为 此 ， 要 使 用 关 刍 


public class MyClass 


字 public: 


// Class members. 


除了 这 两 个 访问 修饰 从 关键 字 外 ， 还 可 以 指定 类 是 抽象 的 (不 能 实例 化 ， 只 能 继承 ， 可 以 有 抽象 成 员 ) 或 密 
封 的 (sealed， 不 能 继承 )。 为 此 ， 可 使 用 两 个 互 斥 的 关键 字 abstract 或 sealed。 所 以 ， 必 须 使 用 下 述 方 式 声 明 抽 
RR: 

public abstract class MyClass 


// Class members, may be abstract. 


其 中 MyClass 是 一 个 公共 抽象 类 ， 也 可 以 是 内 部 抽象 类 。 
密封 类 的 声明 如 下 所 示 : 
public sealed class MyClass 


// Class members. 
} 
与 抽象 类 一 样 ， 密 封 类 也 可 以 是 公共 的 或 内 部 的 。 
还 可 以 在 类 定义 中 指定 继承 。 为 此 ， 要 在 类 名 的 后 和 面 加 上 一 个 冒号 ， 其 后 是 基 类 名 ， 例 如 : 
public class MyClass : MyBase 


// Class members. 


} 
注意 ,在 C# 的 类 定义 中 ,只 能 有 一 个 基 类 。 如 果 继 承 了 一 个 抽象 类 , 就 必须 实现 所 继承 的 所 有 抽象 成 员 ( 除 
非 派 生 类 也 是 抽象 的 )。 


编译 器 不 允许 派生 类 的 可 访问 性 高 于 基 类 。 也 就 是 说 ,内 部 类 可 以 继承 于 一 个 公共 基 类 , 但 公共 类 不 
能 继承 于 一 个 内 部 基 类 。 因 此 ， 下 述 代码 是 合法 的 : 

public class MyBase 

// Class members. 

— class MyClass : MyBase 

l // Class members. 

但 下 述 代码 不 能 编译 : 

internal class MyBase 

| // Class members. 

—— class MyClass : MyBase 


// Class members. 


如 果 没 有 使 用 基 类 ， 被 定义 的 类 就 只 继承 于 基 类 System Object Æ C# 中 的 别名 是 object) EH, A% 
承 层次 结构 中 ， 所 有 类 的 根 都 是 System.Object， 稍 后 将 详细 介绍 这 个 基 类 。 

除了 以 这 种 方式 指定 基 类 外 ， 还 可 在 冒号 之 后 指定 支持 的 接口 。 如 果 指 定 了 其 类 ， 它 必须 紧 跟 在 冒号 的 后 
面 ,之 后 才 是 指定 的 接口 。 如 果 未 指定 基 类 ,接口 就 跟 在 冒号 的 后 面 。 必 须 使 用 逗号 来 分 隔 基 类 名 (如 果 有 基 类 
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的 话 ) 和 接口 名 。 
例如 ， 给 MyClass 添加 一 个 接口 ， 如 下 所 示 : 
public class MyClass : IMyInterface 
{ 


// Class members. 


} 

文 持 该 接口 的 类 必须 实现 所 有 接口 成 员 ， 但 如 果 不 想 使 用 给 定 的 接口 成 员 ， 可 以 提供 一 种 “ 空 ”的 实现 方 
式 (没有 函数 代码 )。 还 可 以 把 接口 成 员 实 现 为 抽象 类 中 的 抽象 成 员 。 

下 面 的 声明 是 无 效 的 ， 因 为 基 类 MyBase 不 是 继承 列表 中 的 第 一 项 : 

public class MyClass : IMyInterface, MyBase 

{ 


// Class members. 


指定 基 类 和 接口 的 正确 方式 如 下 : 
public class MyClass : MyBase, IMyInterface 


// Class members. 


} 

可 以 指定 多 个 接口 ， 所 以 下 列 代码 也 是 有 效 的 : 

public class MyClass : MyBase, IMyInterface, IMySecondInterface 
{ 


// Class members. 


| 
d 9-1 列 出 了 类 定义 中 可 以 使 用 的 访问 修饰 从 的 组 合 。 


表 9-1 类 定义 中 可 以 使 用 的 访问 修饰 符 


修 ih fF a X 

无 或 internal 只 能 在 当前 项 目 中 访问 类 
public 可 以 在 任何 地 方 访问 类 
abstract 或 internal abstract 类 只 能 在 当前 项 目 中 访问 ， 不 能 实例 化 ， 只 能 被 继承 
public abstract 类 可 以 在 任何 地 方 访问 ， 不 能 实例 化 ， 只 能 被 继承 
sealed 或 internal sealed 类 只 能 在 当前 项 目 中 访问 ， 不 能 被 继承 ， 只 能 实例 化 
public sealed 类 可 以 在 任何 地 方 访 问 ， 不 能 被 继承 ， 只 能 实例 化 

接口 的 定义 


声明 接口 的 方式 与 声明 类 的 方式 相似 ， 但 使 用 的 关键 字 是 interface 而 不 是 class， 例 如 ; 
interface IMyInterface 


// Interface members. 


] 


访问 修饰 符 关 键 字 public 和 internal 的 使 用 方式 是 相同 的 ， 与 类 一 样 ， 接 口 也 默认 定义 为 内 部 接口 。 所 以 
要 使 接口 可 以 公开 访问 ， 必 须 使 用 public 关键 字 : 


public interface IMyInterface 


// Interface members. 


| 

不 能 在 接口 中 使 用 关键 字 abstract 和 sealed， 因 为 这 两 个 修饰 符 在 接口 定义 中 是 没有 意义 的 (它们 不 包含 实 
现代 码 ， 所 以 不 能 直接 实例 化 ， 且 必须 是 可 以 继承 的 )。 

也 可 以 用 与 类 继承 类 似 的 方式 来 指定 接口 的 继承 。 主 要 区 别 是 可 以 使 用 多 个 基 接 口 ， 例 如 : 


public interface IMyInterface : IMyBaseInterface, IMyBaseInterface2 
{ 
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// Interface members. 
} 
接口 不 是 类 ， 所 以 没有 继承 System.Object. (AA [f HEEL, System.Object 的 成 员 可 以 通过 接口 类 型 的 变 
量 来 访问 。 如 上 所 述 ， 不 能 用 实例 化 类 的 方式 来 实例 化 接口 。 下 面 的 示例 提供 了 一 些 类 定义 的 代码 和 使 用 它们 
的 代码 。 


试 一 试 ”定义 类 : ChO9Ex01\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter09 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch09Ex01。 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using static System.Console; 
namespace Ch09Ex01 
{ 
public abstract class MyBase {} 
internal class MyClass : MyBase {} 
public interface IMyBaseInterface {} 
internal interface IMyBaseInterface2 {} 
internal interface IMyInterface : IMyBaseInterface, IMyBaseInterface2 {} 
internal sealed class MyComplexClass : MyClass, IMyInterface {} 
class Program 
{ 
static void Main(string[] args) 
{ 
MyComplexClass myObj = new MyComplexcClass(); 
WriteLine (myObj.ToString()):; 
ReadkKey () ; 
} 
} 
} 


(3) 执行 项 目 ， 结 果 如 图 9-1 所 示 。 


图 9-1 
示例 说 明 
这 个 项 目 在 下 面 的 继承 层次 结构 中 定义 了 类 和 接口 ， 如 图 9-2 所 示 。 


«Interface» — — «Interface» 
IMyBaselnterface| |IMyBaselnterface2 


| )IMylnterface 


这 里 之 所 以 包含 Bogram， 是 因为 尽 官 这 个 类 不 是 主要 类 层 饮 结构 中 的 一 部 分 , 但 是 它 的 定义 方式 与 其 他 类 
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的 定义 方式 相同 。 这 个 类 处理 的 Main0 方 法 是 应 用 程序 的 入 口 扣 。 

MyBase 和 IMyBaselnterface 被 定义 为 公共 的 , 所 以 可 以 在 其 他 项 目 中 使 用 它们 。 其 他 类 和 接口 都 是 内 部 的 ， 
只 能 在 本 项 目 中 使 用 。 

Main0 中 的 代码 调用 MyComplexClass 的 一 个 实例 myObj 的 ToString0 方 法 : 


MyComplexClass myObj = new MyComplexClass(); 
WriteLine (myOb].ToString()); 


Mein Ds Tne ne: UM RIETI, UN 
的 类 名 作为 一 个 字符 串 返回 ， 该 类 名 用 相关 的 名 称 空间 来 限定 。 
这 个 示例 没有 完成 什么 具体 工作 ， 但 本 章 后 而 还 要 利用 这 个 示例 来 演示 几 个 重要 概念 和 技术 ， 


9.2 System.Object 
KAMARA 


EK T System.Object， 所 以 这 些 类 都 可 以 访问 该 类 中 受 保 护 的 成 员 和 公共 成 员 。 下 面 看 看 可 
供 使 用 的 成 员 有 哪些 。System.Object 包含 的 方法 如 表 9-2 所 示 。 


表 9-2 System.Object 类 的 方法 
方 法 | 返回 类 型 | 虚拟 e 说 
Object0 wa fe fe System.Object 类 型 的 构造 函数 , 由 派生 类 型 的 构造 函数 自动 调用 


~Object0( 也 称 为 A = System.Object 类 型 的 析 构 函数 ， 由 派生 类 型 的 析 构 函数 目 动 调 
Finalize0， 参 见 下 一 节 ) 用 ， 不 能 手动 调用 


Equals(object) NE S | 把 调用 该 方法 的 对 象 与 另 一 个 对 象 相 比 ， 如 果 它 们 相等 ,就 返回 


true。 默 认 的 实现 代码 会 查看 其 对 象 参数 是 否 引 用 了 同一 个 对 象 
(因为 对 象 是 引用 类 型 )。 如 果 想 以 不 同方 式 来 比较 对 象 ， 则 可 以 
重 写 该 方法 ， 例 如 ， 比 较 两 个 对 象 的 状态 
Equals(object, object) 这 个 方法 比较 传送 给 它 的 两 个 对 象 ， 看 看 它们 是 否 相 等 。 检查 时 
使 用 了 Equals(object) 方 法 。 注意 ， 如 果 两 个 对 象 都 是 空 引用 ， 
这 个 方法 就 返回 true 


ReferenceEquals(object, 否 是 | 这 个 方法 比较 传送 给 它 的 两 个 对 象 , 看 看 它们 是 不 是 同一 个 实例 
ToString() = rr 返回 一 个 对 应 于 对 象 实例 的 字符 串 。 默 认 情况 下 ,这 是 一 个 类 类 
型 的 限定 名 称 ， 但 可 以 重 写 它 ， 给 类 类 型 提供 合适 的 实现 代码 


MemberwiseClone() 通过 创建 一 个 新 对 象 实例 并 复制 成 员 ， 以 复制 该 对 象 。 成 员 复 制 
不 会 得 到 这 些 成 员 的 新 实例 。 新 对 象 的 任何 引用 类 型 成 员 都 将 引 
用 与 源 类 相同 的 对 象 ， 这 个 方法 是 受 保护 的 ， 所 以 只 能 在 类 或 派 
ee 

GetTypeQ) System. Type * * 以 System. Type 对 象 的 形式 返回 对 象 的 类 型 


GetHashCode() 一 一 一 一 一 用 作对 象 的 散 列 函数 ， 它 返回 一 个 以 压缩 
形式 标识 对 象 状态 的 值 


这 些 方法 是 NET Framework 中 对 象 类 型 必须 支持 的 基本 方法 ， 但 我 们 可 能 从 不 使 用 其 中 的 菏 些 类 型 (或 者 
只 在 特殊 情况 下 使 用 ， 如 GetHashCode(). 

在 利用 多 态 性 时 ，GetType0 是 一 个 有 用 的 方法 ， 人 允许 根据 对 象 的 类 型 来 执行 不 同 的 操作 ， 而 不 是 像 通常 那 
样 ， 对 所 有 对 象 部 执行 相同 的 操作 。 例 如 ， 如 果 函 数 接 受 一 个 object 类 型 的 参数 (表示 可 以 给 该 国 数 传送 任何 信 
居 )， 就 可 以 在 遇 到 菜 些 对 象 时 执行 额外 的 任务 。 组 合 使 用 GetType0 和 typeof( 这 是 一 个 CHA, JUEK Z 
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转换 为 System. Type 对 象 )， 就 可 以 进行 比较 操作 ， 如 下 所 示 : 

if (myObj.GetType() == typeof (MyComplexClass)) 

i // myObj is an instance of the class MyComplexClass. 

返回 的 System. Type 对 象 可 以 完成 更 多 工作 ， 这 里 不 讨论 它们 。 重 写 ToStingQ 5 e JF78 4 HH, EX 
象 的 内 容 可 以 用 一 个 人 们 能 理解 的 字符 串 表示 时 ， 尤 其 如 此 。 后 续 章节 将 反复 讨论 这 些 System Object 方法 ， 
现在 就 讨论 到 这 里 为 止 ， 后 面 在 需要 时 再 详细 讨论 。 


93 ”构造 函数 和 析 构 函数 


在 C# 中 定义 类 时 ， 第 间 不 需要 定义 相关 的 构造 函数 和 析 构 函数 ， 因 为 在 编写 代码 时 ， 如 果 没 有 提供 它们 ， 
编译 器 会 自动 添加 它们 。 但 是 ， 如 有 必要 ， 可 以 提供 自己 的 构造 函数 和 析 构 函数 ， 以 便 初 始 化 对 象 和 清理 对 象 。 

使 用 下 述 语法 可 以 把 一 个 简单 的 构造 函数 添加 到 类 中 

class MyClass 

i public MyClass () 


{ 
// Constructor code. 


} 
这 个 构造 函数 与 包含 它 的 类 同名 ， 且 没有 参数 (使 其 成 为 类 的 默认 构造 函数 )， 这 是 一 个 公共 函数 ， 所 以 类 
的 对 象 可 以 使 用 这 个 构造 函数 进行 实例 化 ( 详 见 第 8 Bt). 
也 可 以 使 用 私有 的 默认 构造 函数 ， 一 般 仅 包含 静态 成 员 的 类 会 使 用 。 即 不 能 用 这 个 构造 函数 来 创建 这 个 类 
的 对 象 实例 ( 它 是 不 可 创建 的 ， 详 见 第 8 章 ): 
class MyClass 
private MyClass () 
i // Constructor code. 
} 
最 后 ， 通 过 提供 参数 ， 也 可 以 采用 相同 的 方式 给 类 添加 非 默认 的 构造 函数 ， 例 如 ; 
class MyClass 
public MyClass () 
// Default constructor code. 
PR MyClass (int myInt) 


// Nondefault constructor code (uses myInt). 


} 
可 提供 的 构造 函数 的 数量 不 受 限制 (当然 不 能 耗 尽 内 存 ， 也 不 能 有 相同 的 参数 集 ， 所 以 “几乎 不 受 限 ”更 
合适 )。 


使 用 略微 不 同 的 语法 来 声明 析 构 函数 。 在 .NET 中 使 用 的 析 构 函数 (由 System.Object 类 提供 ) 称 为 Finalize), 但 
这 不 是 我 们 用 于 声明 析 构 函数 的 名 称 。 使 用 下 和 面 的 代码 ， 而 不 是 重 写 Finalize(): 
class MyClass 
~MyClass () 
// Destructor body. 
} 
} 
RARA 543 — BU 2 EE] 2S 5 2 E E CUTS HL 2845 95883). “SEAT ERIE, RT HTE ER 
数 中 的 代码 ， 释 放 资 源 。 调 用 这 个 析 构 函数 后 ， 还 将 隐 式 地 调用 基 类 的 析 构 函数 ， 包 括 System.Object 根 类 中 的 
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FinalizeO 调 用 。 该 技术 可 以 让 NET Framework 确保 调用 Finalize0， 因 为 重 写 Finalize0 则 意味 着 需要 显 式 地 执 
行 基 类 调用 ， 这 具有 潜在 危险 (第 10 章 将 详细 讨论 如 何 调用 基 类 的 方法 )。 


构造 函数 的 执行 序列 


如 果 在 类 的 构造 函数 中 执行 多 个 任务 ， 把 这 些 代 码 放 在 一 个 地 方 古 非 沼 方 便 的 ， 这 与 第 6 FERIER 
放 在 函数 中 具有 相同 的 优势 。 使 用 一 个 方法 束 可 以 把 代码 放 在 一 个 地 方 ( 详 见 第 10 Bt), 1B C# 提 供 了 一 种 更 好 
的 方式 。 任 何 构造 函数 都 可 以 配置 为 在 执行 目 己 的 代码 前 调用 其 他 构造 图 数 。 

在 讨论 构造 函数 前 ， 先 看 一 下 在 默认 情况 下 ， 创 建 类 的 实例 时 会 发生 什么 。 除 了 前 面 说 过 的 便于 把 初始 化 
代码 集中 起 来 外 ， 还 要 了 解 这 些 代码 。 在 开 友 过 程 中 ， 由 于 调用 构造 测 数 时 可 能 出 现 错误 ， 对 象 常 党 并 没有 按 
照 预期 的 那样 执行 。 发 生 构造 图 数 调用 错误 亲 彰 是 因为 类 继承 结构 中 的 茶 个 基 类 没有 正确 实例 化 ， 或 者 没有 正 
确 地 给 基 类 构造 国 数 提供 信息 。 如 果 理 解 在 对 象 生命 周 期 的 这 个 阶段 友 生 的 事情 ， 将 更 利于 解决 此 类 问题 。 

为 了 实例 化 派生 的 类 ， 必 须 实 例 化 它 的 基 类 。 而 要 实例 化 这 个 基 类 ， 又 必须 实例 化 这 个 基 类 的 基 类 ， 这 样 
一 直到 实例 化 System.Object( 所 有 类 的 根 ) 为 止 。 结 果 是 无 论 使 用 什么 构造 函数 实例 化 一 个 类， 总 是 首先 调用 
System.Object.Object(). 

FE VETERE 2S. EE FR FT A x ER ERA ETFs ERI CEA BA HI Pe PA), ERE RAAT E. AAEH SE 
类 的 默认 构造 函数 ( 稍 后 将 介绍 如 何 改变 这 个 行为 )。 下 面 介 绍 一 个 简短 示例 ， 来 演示 执行 顺序 。 考 虑 下 面 的 对 
象 层次 结构 : 

public class MyBaseClass 

public MyBaseClass () 


{ 


} 
public MyBaseClass(int 1) 


} 
} 
public class MyDerivedClass : MyBaseClass 
{ 

public MyDerivedclass () 


} 
public MyDerivedclass (int i) 
i 


} 
public MyDerivedClass(int i, int j) 


} 
} 


如 果 以 下 和 面 的 方式 实例 化 MyDerivedClass: 
MyDerivedClass myObj = new MyDerivedClass(); 

则 执行 顺序 如 下 : 

e 执行 System.Object.Object()f iz PK ŽU. 

e 执行 MyBaseClass.MyBaseClass()f4J ii PAI ŽU. 

e 执行 MyDerivedClass.MyDerivedClass() #4 ii PA 2 © 
另外 ， 如 果 使 用 下 面 的 语句 : 

MyDerivedClass myObj = new MyDerivedclass (4); 

则 执行 顺序 如 下 : 

e 执行 System.Object.Object() £435 pK BL. 

e 执行 MyBaseClass.MyBaseClass() 35 PAI ŽU 

e 执行 MyDerivedClass.MyDerivedClass(int 1) 构造 函数 。 
最 后 ， 如 果 使 用 下 面 的 语句 : 


MyDerivedClass myObj = new MyDerivedClass(4, 8); 
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则 执行 顺序 如 下 : 

e 执行 System.ObjectObjectO 构 造 函 数 。 

e 执行 MyBaseClass.MyBaseClass() FJ3& PA ŽU. 

e 执行 MyDerivedClass.MyDerivedClass(int i, int j) 38: AŽ. 

大 多 数 情 况 下 ， 这 个 系统 都 能 正常 工作 。 但 是 ， 有 了 时 需要 对 友 生 的 事件 进行 更 多 控制 。 例 如 ， 在 上 和 面 的 实 
例 化 示例 中 ， 可 能 想得到 如 下 所 示 的 执行 顺序 : 

e 执行 System.Object.Object0 构 造 函 数 。 

e 执行 MyBaseClass.MyBaseClass(int i) Jizz PRI 2 

e 执行 MyDerivedClass.MyDerivedClass(int i, intj) 构 造 函 数 。 

使 用 这 个 顺序 ， 可 以 把 使 用 int 1 参数 的 代码 放 在 MyBaseClass(int i), EP MyDerivedClass(int i, int j) 构 造 国 数 要 做 
的 工作 较 少 ， 只 需要 处 理 intj 参数 (假定 inti 参数 在 两 种 情况 下 的 含义 相同 ， 虽 然 事 情 并 非 总 是 如 此 ， 但 实际 上 我 们 常 
做 这 样 的 安排 )。 只 要 愿意 ，C# 就 可 以 指定 这 种 操作 。 

为 此 ， 只 需要 使 用 构造 图 数 初 始 化 器 (constructor initializer)， 它 把 代码 放 在 方法 定义 的 冒号 后 务 。 例 如 ， 可 
以 在 派生 类 的 构造 函数 定义 中 指定 所 使 用 的 基 类 构造 函数 ， 如 下 所 示 : 

p class MyDerivedClass : MyBaseClass 

public MyDerivedClass(int i, int j) : base(i) 
| 

} 

其 中 , base 关键 字 指 定 .NET 实例 化 过 程 使 用 基 类 中 具有 指定 参数 的 构造 函数 。 这 里 使 用 了 一 个 int 参数 (其 
值 通 过 参数 i 传递 给 MyDerivedClass 构造 图 数 )， 所 以 将 使 用 MyBaseClass(int i). KA MUR AS val AA 
MyBaseClass0， 而 是 执行 本 例 前 面 列 出 的 事件 序列 一 一 也 就 是 我 们 布 望 执行 的 事件 序列 。 

也 可 以 使 用 这 个 关键 字 指 定 基 类 构造 国 数 的 字面 值 ， 例 如 ， 使 用 MyDerivedClass 的 默认 构造 函数 来 调用 
MyBaseClass 的 非 默 认 构 造 图 数 : 

public class MyDerivedClass : MyBaseClass 

| public MyDerivedClass() : base(5) 

} 

} u 

这 段 代 码 将 执行 下 述 序列 : 

e 执行 System.Object.Object() Miz PAI ŽL. 

e 执行 MyBaseClass.MyBaseClass(int DHJE PRI ŽU. 

e 执行 MyDerivedClass.MyDerivedClass()}4J ia ER ŽL 

除了 base 关键 字 外 ， 这 里 还 可 将 另 一 个 关键 字 this HPP RA a XX ESE TE TE ed H3 TH EH 
构造 国 数 前 ，.NET 实例 化 过 程 对 当前 类 使 用 非 默 认 的 构造 函数 。 例 如 : 

public class MyDerivedClass : MyBaseClass 


public MyDerivedClass() : this(5, 6) 

{ 

} 

public MyDerivedClass(int i, int j) : base(i) 


} 
} 
使 用 MyDerivedClass.MyDerivedClass() Jit RRG FS 21) G0 PA UT: 
e 执行 System.Object.Object() Miz PAI AX 
e 执行 MyBaseClass.MyBaseClass(int i) PAI A © 
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e 执行 MyDerivedClass.MyDerivedClass(int i, int ) 构 造 函 数 。 

e 执行 MyDerivedClass.MyDerivedClass() FJ3 PA ŽL. 

EE — FY PR fll ae fs FRAIS PA ea as HEE Pe PA. 但 如 上 例 所 示 , 这 并 不 是 一 个 很 严格 的 限制 ， 
因为 我 们 仍 可 以 构造 相当 复杂 的 执行 顺序 。 


注意 : 

如 果 没 有 给 构造 函数 指定 构造 函数 初始 化 器 ,编译 器 会 自动 添加 base0。 这 会 导致 执行 本 节 前 面 介绍 的 默 
认 顺 厅 。 

注意 在 定义 构造 函数 时 ， 不 要 创建 无 限 循环 。 例 如 : 

public class MyBaseClass 


public MyBaseClass() : this(5) 
{ 
} 
public MyBaseClass(int 1) : this() 
{ 
} 
} 


TE FH bE — ARERR PT HE CBT 23 ee, m 23 — 71 1438 PR OR 263441 JE ee PR 
数 。 这 段 代码 可 以 编译 ， 但 如 果 和 尝试 实例 化 MyBaseClass， 就 会 得 到 一 个 SystemOverflowException 异常 。 


9.4 Visual Studio 中 的 OOP 工具 


OOP 在 NET Framework 中 是 一 个 非常 基础 的 主题 ， 所 以 Visual Studio 提供 了 几 个 工具 来 帮助 开发 OOP 应 
用 程序 。 本 节 就 介绍 其 中 的 一 些 工具 。 


941 Class View 窗口 


第 2 章 介绍 了 Solution Explorer 窗口 与 Class View 窗口 共用 相同 的 空间 。 这 个 窗口 显示 了 应 用 程序 中 的 类 
层次 结构 ， 可 供 查看 我 们 使 用 的 类 的 特性 。 对 于 上 一 节 的 示例 项 目 ， 其 Class View 视图 如 图 9-3 所 示 。 
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X^ ii APB oP, AK PI] — Eon SABI. HERS, Bd 9-3 显示 的 是 选中 Class View Settings 下 拉 
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Dll 


列表 (位 于 Class View 窗口 的 项 部 ) 中 的 全 部 项 以 后 的 Class View 窗口 。 
这 里 使 用 了 许多 符号 ， 如 表 9-3 所 示 。 


表 9-3 Class View 窗口 使 用 的 图 标 


B ^5 B 标 & x 

事件 

() 委托 
程序 集 


注意 ， 其 中 一 些 图 标 用 于 类 型 定义 而 不 是 类 定义 ， 例 如 枚 举 和 结构 类 型 。 
其 中 一 些 项 的 下 面 还 有 其 他 符号 ,表示 它们 的 访问 级 别 (公共 项 没有 这 样 的 符号 ), 表 9-4 中 列 出 了 这 些 符号 。 


表 9-4 Class View 窗口 中 使 用 的 其 他 图 标 
图 标 | a x | 图 标 | 含义 | 图 标 | $ x 
a 受 保护 的 里 | 内 部 的 


没有 符号 用 于 表示 抽象 、 密 封 或 虚拟 项 。 

在 这 里 除了 可 以 得 看 信息 外 ， 还 可 以 访问 许多 项 的 相关 代码 。 双 击 有 某 项 ， 或 者 右 击 该 项 ， 然 后 选择 Go To 
Definition， 束 可 以 查看 项 目 中 用 于 定义 该 项 的 代码 (假定 代码 是 可 以 查看 的 )。 如 果 无 法 得 看 代码 ， 例 如 不 能 访 
问 基 类 型 System.Object 中 的 代码 ， 就 应 该 选择 Browse Definition， 打 开 Object Browser 视图 ( 详 见 下 一 节 )。 

图 9-3 显示 的 男 一 项 是 Project References, 通过 它 可 以 查看 项 目 引 用 了 哪些 程序 集 , 本 例 的 项 目 包含 mscorlib 
和 System 中 的 核心 .NET 类 型 、 System.Data 中 的 数据 访问 类 型 和 System.Xml 中 的 XML 操纵 类 型 。 这 里 的 引 
用 也 是 可 以 扩展 的 ， 以 显示 这 些 程序 集中 包含 的 名 称 空 间 和 类 型 。 

Class View 还 可 以 得 找 代 码 中 的 类 型 和 成 员 。 其 方法 是 , 右 击 一 项 , 选择 Find All References, 就 会 在 Find Symbol 
Results 窗口 中 打开 搜索 结果 列表 , 该 窗口 位 于 屏 硕 底部 , 是 Error List 显示 区 域 的 一 个 选项 卡 。 还 可 以 使 用 Class View 
窗口 对 项 进行 重 命 名 。 在 重 命 名 时 ， 可 以 重 命 名 代码 中 出 现 的 项 的 引用 。 也 就 是 说 ， 没 有 理由 在 类 名 中 出 现 拼写 错 
误 ， 因 为 我 们 可 以 随时 修改 它们 。 

另外 ， 使 用 Call Hierarchy 视图 可 以 在 代码 中 导航 。 在 Class View 窗口 中 通过 选择 View Call Hierarchy, 41 
击 淋 单项 就 可 以 访问 Call Hierarchy 窗口 。 这 个 功能 非常 适 于 得 看 类 成 员 彼此 之 间 的 交互 方式 ， 参 见 下 一 草 。 


942 对象 浏览 器 


对 和 象 浏览 器 (Object Browser) 是 Class View 窗口 的 扩展 版 本 ， 可 以 查看 项 目 中 能 使 用 的 其 他 类 ， 甚 至 可 以 但 
看 外 部 的 类 。 可 以 自动 (如 上 一 节 的 情况 ) 或 手动 (通过 View | Object Browser) 进 入 这 个 窗口 。 这 个 视图 显示 在 主 
窗口 中 ， 可 以 采用 与 Class View 窗口 相同 的 方式 浏览 该 视图 。 

这 个 窗口 显示 与 Class View 窗口 相同 的 信息 ,还 显示 了 NET 类 型 的 其 他 信息 。 选 中 某 项 ,还 可 以 在 第 三 个 
窗口 中 获得 该 项 的 信息 ， 如 图 9-4 所 示 。 

在 图 9-4 中 ， 选 中 了 Console 类 的 ReadKey0 方 法 (Console 在 mscorlib 程序 集 的 System 名 称 空 间 中 )。 右 下 
角 的 信息 窗口 显示 了 方法 签名 、 访 方法 所 属 的 类 和 方法 功能 的 小 结 。 在 研究 .NET 类 型 时 , 或 者 在 了 解 某 个 类 的 
用 途 时 ， 这 些 信息 非常 有 用 。 


Browse: My Solution 
«Search» 


b fg BitConverter 

b sa Boolean 

b *w Buffer 

b sa Byte 

b> $ CannotUnioadAppDomainException 
b sa Char 

b fe CharEnumerator 

b fe CLSCompliantAttribute 

b & Comparison<in T» 

b fe Console 

P fe ConsoleCancelEventArgs 

P & ConsoleCancelEventHandler 
P & ConsoleColor 

> a ConsoleKey 

b me ConsoleKeyInfo 

b & ConsaleModifiers 

b = ConsoleSpecialKey 

b 4» ContextBoundObject 

b *» ContextMarshalException 

P *w ContextStaticAttribute 

> $e Convert 

> & Converter«in Tinput, out TOutput> 
P & CrossAppDomainDelegate 
b ** DataMisalignedException 

b me DateTime 

b & DateTimeKind 

b ea DateTimeOffset 

EF a DayOfWeek 

> #3 DBNull 

b ea Decimal 

b 95» Delegate 

b Ae DivideByZeroException 

b Se DIINotFoundException 

b =e Double 

b *v DuplicateWaitObjectException 
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OpenStandardErrar() 
OpenStandardError(int) 
OpenStandard|nput() 
OpenStandardinput(int) 
OpenStandardOutput() 
OpenStandardOutput(int) 
Readi) 


ReadKey(bool) 

ReadLine() 

ResetColor() 

SetbutferSizetint, int) 

SetCursorPositiontint, int) 

setEmor(System.IO.TextWriter) 

Setin(System.IO. TextReader) 

SetOut(System.IO TextWriter) 

SetWindowPosition(int, int) 

SetWindowSize(int, int) 

Writeíhooh 

public static System.ConsoleKeylInfo ReadKey() 
Member of System.Console 


oeoeBocococcoccoccoococooccocesg 


Summary: 
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Obtains the next character or function key pressed by the user. The pressed key is displayed in the console window. | 


Returns: 


A System.ConsoleKeyInfo object that describes the System.ConsoleKey constant and Unicode character, if any, that | 
correspond to the pressed console key. The System.ConsoleKeyInfa object also describes, in a bitwise combination | 
of System.ConsoleModifiers values, whether one or more Shift, Alt, or Ctrl modifier keys was pressed simultaneously | 


with the console key. 


Exceptions: 
System.InvalidOperationException: The System.Console.In property is redirected from some stream other than 
. the console, 


图 9-4 


还 可 在 自己 创建 的 类 型 中 使 用 这 个 信息 窗口 。 对 Ch09Ex01 中 的 代码 进行 如 下 修改 : 


/// <summary> 


/// This class contains my program! 


/// </summary> 
class Program 


new MyComplexclass(); 


i 
static void Main(string[] args) 
{ 
MyComplexClass myObj 
WriteLine (myObj.ToString()): 
ReadKey () ; 
} 
} 


然后 返回 到 对 象 浏览 万 并 导航 到 ChO9ExO1 项 目 中 的 Program 类 ， 吏 会 看 到 这 些 变化 反映 在 信息 窗口 中 。 
这 是 XML 文档 说 明 的 一 个 示例 ， 本 书 不 讨论 XML 文档 说 明 ， 但 读者 有 闲暇 时 间 时 ， 应 学 习 这 个 主题 。 


注意 : 


如 果 手 动 修改 上 面 的 代码 , 只 要 键入 3 AS BH, IDE 就 会 添加 输入 的 其 他 内 容 。 它 会 自动 分 析 应 用 于 XML 
文档 说 明 的 代码 ， 建 立 基 本 的 XML 文档 说 明 。 显 然 ， 这 进一步 证 明了 Visual Studio 是 一 个 功能 十 分 强大 的 


工具 


943 添加 类 


Visual Studio 包含 可 以 加 速 执行 某 些 第 见 任务 的 工具 ， 其 中 一 些 可 以 应 用 于 OOP。 有 一 个 Add New Item 
Wizard 工具 可 以 为 项 目 快 速 添 加 新 类 ， 且 需要 键入 的 代码 量 最 少 。 
通过 单 击 Project | Add New Item 3M, 或 在 Solution Explorer 窗口 中 右 击 项 目 ， 选 择 相 应 的 项 ， 可 以 打开 
该 工具 。 末 用 其 中 任意 一 种 方式 ， 部 会 打开 一 个 对 话 框 ， 在 该 对 话 框 中 ， 可 以 选择 要 添加 的 项 。 要 添加 一 个 类 ， 
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可 以 在 模板 窗口 中 选择 Class 项 ， 如 图 9-5 所 示 ， 为 包 售 类 的 文件 提供 一 个 文件 名 ， 再 单 击 Add 按钮 。 所 创建 
的 类 束 以 所 提供 的 文件 名 命名 。 

EA SE Bü Iz prp, RIJE Program.cs 文件 中 手动 添加 类 定义 。 把 类 放 在 独立 的 文件 中 ， 第 党 可 以 更 
轻松 地 跟 中 类。 打开 Ch09Ex01 项 目 后 ， 在 Add New Item 对 话 框 中 输入 信息 ， 就 会 在 MyNewClass.cs 中 生成 下 
列 代码 : 

using System; 

using System.Collections.Generic; 

using System.Linq; 

using System.Text; 


using System.Threading.Tasks; 
namespace ChO0SEx01 


class MyNewClass 


] 
} 


4 Installed Sort by: Default "| si” |s Search Installed Templates (Ctrl * E) P~- 


: al. z 
4 Visual C# Items r Visual C# Items Type: Visual C£ Items 


Code An empty class definition 


Data e-Q interface Visual C# Items 
General 


b Web Windows Form Visual C# Items 
Windows Forms 


WPF 5] User Control Visual C# Items 
> ASP.NET Core 


SOL Server " | Component Class Visual C# Items 
b Online : 
| M User Control (WPF) Visual C# Items 
iH? 
About Box Visual C# Items 


M. ADO.NET Entity Data Model Visual C# Items 


MyNewcClass.cs 


图 9-5 


MyNewClass 类 在 入 口 扣 类 Program ERARE EM, ATO EIS AE, ete EAA) 
XPE. IRIS PR DA, AERIAL ae eA. MRE MRA EL, BaF ASS 
在 编 详 代 码 时 目 动 添加 一 个 默认 构造 函数 。 


944 类 图 


还 没有 介绍 的 Visual Studio 的 一 个 强大 功能 是 从 代码 中 生成 类 图 , 并 使 用 类 图 修改 项 目 。Visual Studio 中 的 
关 图 编辑 需 可 以 很 方便 地 为 代码 生成 关 似 于 UML 的 图 。 为 摘 述 这 个 功能 , 下面 的 示例 将 为 前 面 创 建 的 Ch09Ex01 
项 目 生 成 类 图 。 


注意 : 

Class Designer 是 一 个 可 选 的 组 件 ， 在 默认 情况 下 不 会 安装 它 。 要 完成 下 面 的 示例 ， 人 必须 安装 该 组 件 。 如 果 
没有 看 到 View Class Diagram 选项 或 者 不 能 添加 一 个 新 的 类 图 ， 就 需要 再 次 运行 Visual Studio 安装 程序 并 安装 
Class Designer. 


试 一 试 ”生成 类 图 


(1) 打开 本 章 前 和 面 创 建 的 Ch09Ex01 项 目 。 
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(2) 在 Solution Explorer 窗口 中 ， 右 击 ChO9Ex01 项 目 ， 在 上 下 文集 单 中 选择 View | View Class Diagram 3 
单项 。 

(3) 此 时 会 显示 类 图 ClassDiagraml.ed. 

(4) 右 击 MyBase， 从 上 下 文集 单 中 选择 Show Base Type 选项 。 

(5) 拖 动 图 中 的 对 象 ， 生 成 较 美 观 的 布局 。 完 成 这 些 步 又 后 ， 类 图 将 如 图 9-6 所 示 。 


ClassDiagraml.cd ^ > 


 IMyBaselnterface *¥ | IMyBaselnterfac... ¥ 
interface Interface 


| IMyinterface v 
Interface 
+ |My&aselnterface 
+ IMy&Baselnterfacez 


MyComplexClass — 


Sealed Class a A 
+ MyClass 


示例 说 明 
在 本 例 中 台 不 费力 地 创建 了 一 个 与 UML 图 ( 见 图 9-2) 非 常 类 似 的 类 图 ， 下 面 的 特性 得 到 了 证 明 : 
e 显示 的 类 的 名 称 和 类 型 。 
显示 的 接口 包含 接口 的 名 称 和 类 型 。 
KAA ake, SEL, AEP ALIA. 
实现 接口 的 类 有 “ 棒 棒 糖 ” 图 标 。 
抽象 类 显示 为 虚 点 外 框 ， 名 称 显 示 为 斜体 。 
密封 类 显示 为 粗 黑 外 框 。 
单 击 一 个 对 象 会 在 屏幕 底部 的 Class Details 窗口 中 显示 其 他 信息 (如 果 Class Details 窗口 没有 显示 出 来 ， 可 以 
右 击 一 个 对 象 , 然后 选择 Class Details)。 可 以 在 此 得 看 (和 修改 ) 类 成 员 , 还 可 以 在 Properties 窗口 中 修改 类 的 信息 。 
在 Toolbox 中 ， 可 以 给 图 添加 新 项 ， 例 如 类 、 接 口 和 枚 举 等 ， 定 义 图 中 对 和 象 之 间 的 关系 。 此 时 ， 新 项 的 代 
码 会 目 动 生 成 。 
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除了 在 项 目 中 把 类 放 在 不 同 的 文件 中 之 外 ， 还 可 以 把 它们 放 在 完全 不 同 的 项 目 中 。 如 果 一 个 项 目 只 包含 类 
(以 及 其 他 相关 的 类 型 定义 ， 但 没有 入 口 点 )， 该 项 目 就 称 为 类 库 (class library). 

类 库 项 目 编译 为 .dl 程序 集 ， 在 其 他 项 目 中 添加 对 类 库 项 目的 引用 后 ， 融 可 以 访问 它 的 内 容 ， 这 可 以 是 (也 
可 以 不 是 ) 同 一 个 解决 方案 的 一 部 分 。 这 扩展 了 对 象 提供 的 封 疼 性 ， 因 为 修改 和 更 新 类 库 不 会 影 啊 使 用 它们 的 其 
他 项 目 。 这 意味 着 ， 可 以 方便 地 升级 类 提供 的 服务 (这 会 影响 多 个 使 用 这 些 类 的 应 用 程序 )。 


150 | 第 1 部 分 c# BS 


下 面 看 一 个 类 库 项 目的 示例 和 一 个 利用 该 类 库 项 目 包 含 的 类 的 独立 项 目 。 


试 一 试 ” 使 用 类 库 : Ch09ClassLib 和 Ch09Ex02\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter09 目录 中 创建 一 个 Class Library 类 型 的 新 项 目 Ch09ClassLib， 如 图 9-7 
所 示 。 


b Recent .NET Framework 4.7 * Sort by: Default * ai” Search Installed Templates (Ctrl+E) Pe 


4 Installed " " m" | 
Windows Forms App (NET Framework) Visual C# Type: Visual C# 


4 Visual CF A project for creating a C* class library 
Windows Universal ry Console App (.NET Core) Visual C# (dill) 
Windows Classic Desktop , 
Web Console App (NET Framework) Visual C# 
-NET Core 
-NET Standard 
Cloud 
Test 


Class Library (NET Standard) Visual C# 
| Class Library (NET Framework) Visual Cs 


| l ASP.NET Web Application CNET Frameworl Visual C# 
P Other Languages PP " ls 


Not finding what you are looking for? ^ ASP.NET Core Web Application (.NET Core) Visual C# 


Open Visual Studio Installer 
ASP.NET Core Web Application NET Framework) Visual C# 
b Online 


Shared Project Visual Cs 


Mame: Chü9ClassLib 


Location: C:\BeginningCSharp7\Chapter09\, ii 


图 9-7 


(2) 把 文件 Classl.cs 重合 名 为 MyExternalClass.es(ft Solution Explorer 窗口 中 右 击 该 文件 ,然后 选择 Rename 
来 重 命 名 该 文件 名 )。 在 弹出 的 对 话 框 中 单 击 Yes 按钮 。 
(3) MyExtemalClass.cs 中 的 代码 随 之 目 动 改变 ， 以 反映 类 名 的 改变 : 


public class MyExternalClass 


{ 
} 


(4) 使 用 文件 名 MylInternalClass.cs 给 项 目 添加 一 个 新 类 。 
(5) 修改 代码 ， 显 式 地 指定 类 MylnternalClass 是 内 部 类 : 


internal class MyInternalClass 


{ 
} 


(6) 编 详 项 目 (注意 这 个 项 目 没 有 入 口 点 ， 所 以 不 能 像 通 利 那样 运行 它 一 一 可 以 选择 Build | Build Solution 5i 
单项 来 生成 它 )。 

(7) 在 C:\BeginningCSharp7\Chapter09 目录 中 创建 一 个 新 的 控制 台 应 用 程序 项 目 Ch09Ex02。 

(8) 选择 Project | Add Reference 有 末 单 项 , 或 者 在 Solution Explorer 窗口 中 右 击 References， 选 择 相 同 的 选项 。 

(9) 单 击 Browse 选项 , 之 后 单 击 Browse 按钮 , 导航 到 C:\BeginningCSharp7\Chapter09\Ch09ClassLib\bin\Debug\, 
双击 Ch09ClassLib.dll， 然 后 单 击 OK 按钮 。 

(10) 完成 上 述 操作 后 ， 检 得 是 否 已 将 引用 添 加 到 Solution Explorer 窗口 中 ， 如 图 9-8 所 示 。 
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Solution Explorer 


AA- © SOAR F|-| 


Search Solution Explorer (Ctrl) P- 


p ChO9ClassLib 
b ChO9Ex01 
4 [ed ChO9Ex02 
b p Properties 
4 eE References 
@ Analyzers 
eE Microsoft.CSharp 
"E System 
"B System.Core 
#8 System.Data 
eE System.Data, DataSetExtensions 
"B System.NetHttp 
"B System. Xml 
"B System. Xml.Linq 
+0 App.config 
P ^ €* Program.cs 
P [e] BeginningCSharp7 


Solution Explorer | Team Explorer Class View 


4 9-8 


(11) 打开 Object Browser 窗口 ， 检 查 新 引用 ， 看 看 其 中 包含 的 对 象 ， 结 果 如 图 9-9 所 示 。 


Browse: My Solution 
<Search> 
4 () Ch09ClassLib 
4 ** MyExternalClass 


4 © Base Types 
4» Object 


E=] Ch09Ex02 


"E Microsoft.CSharp 

*-B mscorlib 

E System Assembly Cho9ClassLib 

0-8 System.Core C:\\BegVCSharp\Chapter09\Ch09ClassLib\bin\Debug\Ch09ClassLib.dll 
+E System.Data 

"E System.Data.DataSetExtensioi 

"a System.Xml 

"E System.Xml.Linq 


(12) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System.Threading.Tasks; 
using static System.Console; 
using ChO09ClassLib; 

namespace ChO9Ex02 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
MyExternalClass myObj = new MyExternalClass(); 
WriteLine (imyObj.ToString()): 
| ReadKey () ; 
] 
} 
} 


(13) 运行 应 用 程序 ， 结 果 如 图 9-10 所 示 。 
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图 9-10 


示例 说 明 

这 个 示例 创建 了 两 个 了 项目， 一 个 是 类 库 项 目 ， 另 一 个 是 控制 台 应 用 程序 项 目 。 类 库 项 目 Ch09ClassLib 包 
含 两 个 类 : MyYExternalClass( 可 公开 访问 ) 和 MyInternalClass( 只 能 在 内 部 访问 )。 注 意 ， 默 认 情 况 下 ， 会 隐 式 将 
类 确定 为 供 内 部 访问 ， 因 为 它 没 有 访问 修饰 竺 。 最 好 显 式 指定 可 访问 性 ， 因 为 这 会 使 代码 更 便于 理解 ， 所 以 
指令 增加 了 internal 关键 字 。 控 制 台 应 用 程序 项 目 Ch09Ex02 包含 利用 类 库 项 目的 简单 代码 。 


注意 : 
当 应 用 程序 使 用 外 部 库 中 定义 的 类 时 ， 可 以 把 该 应 用 程序 称 为 库 的 客户 应 用 程序 。 使 用 所 定义 的 类 的 代码 
一 般 简称 为 客户 代码 ， 


为 使 用 Ch09ClassLib FRÆ, EFt S MAHET PARIN T X} Ch09ClassLib.dll 的 引用 。 对 于 这 个 示例 ， 该 
引用 指 同类 库 的 输出 文件 ， 不 过 也 可 以 把 这 个 文件 复制 到 Ch09Ex02 的 本 地 位 置 ， 以 便 继 续 开发 类 库 ， 而 不 影 
啊 控制 台 应 用 程序 。 为 用 新 类 库 项 目 蔡 换 旧 版 本 的 程序 集 ， 只 需要 用 新 生成 的 DLL PHE m IHRE. 

添加 引用 后 ， 束 可 以 使 用 对 象 浏览 器 查看 可 用 的 类 。 因 为 类 MyIntermalClass 下 内 部 的 ， 所 以 在 对 象 浏览 器 
窗口 中 看 不 到 这 个 类 一 一 它 不 能 由 外 部 项 目 访问 。 但 是 ，MyExtemalClass 是 可 供 访 问 的 ， 它 是 我 们 在 控制 台 应 
用 程序 中 使 用 的 类 。 

可 将 控制 全 应 用 程序 中 的 代码 从 换 为 使 用 内 部 类 的 代码 ， 如 下 所 示 : 

static void Main(string[] args) 
E cmm myObj = new MyInternalClass(): 


WriteLine ((myObj.ToString()); 
ReadkKey () ; 


如 果 试 图 编 详 这 段 代 个 ， 就 会 产生 如 下 编 详 错 误 : 


'Ch09ClassLib.MyInternalClass' 
is inaccessible due to its protection level 


利用 外 部 程序 集中 的 类 的 技术 是 使 用 C# 和 .NET Framework 编程 的 关键 。 
的 任何 类 ， 也 就 是 在 利用 外 部 程序 集中 的 类 ， 因 为 它们 的 处 理 方式 是 相同 的 。 


96 ”接口 和 抽象 类 


本 章 介 绍 了 如 何 创 建 接口 和 抽象 类 (现在 不 考虑 其 成 员 ， 第 10 章 会 讲述 类 的 成 员 )。 这 两 种 类 型 在 许多 方面 
都 十 分 类 似 ， 所 以 应 看 一 下 它们 的 相似 和 不 同 之 处 ， 看 看 哪些 情况 应 使 用 什么 技术 。 

首先 讨论 它们 的 相似 之 处 。 抽 象 类 和 接口 都 包含 可 以 由 派生 类 继承 的 成 员 。 接 口 和 抽象 类 都 不 能 直接 实例 
化 , 但 可 以 声明 这 些 类 型 的 变量 。 如 果 这 样 做 , 束 可 以 使 用 多 态 性 把 继承 这 两 种 类 型 的 对 象 指定 给 它们 的 变量 。 
接 看 通过 这 些 变量 来 使 用 这 些 类 型 的 成 员 ， 但 不 能 和 直接 访问 派生 对 象 的 其 他 成 员 。 

下 面 分 析 它 们 之 间 的 区 别 。 派生 类 只 能 继承 日 一 个 基 类 , 即 只 能 和 直接 继承 目 一 个 抽象 类 (但 可 以 用 一 个 继承 
链 包 含 多 个 抽象 类 )。 相 反 ， 类 可 以 使 用 任意 多 个 接口 。 但 这 不 会 产生 太 大 的 区 别 一 一 这 两 种 情况 取得 的 效果 是 
关 似 的 。 只 是 采用 接口 的 方式 稍 有 不 同 。 

抽象 类 可 以 拥有 抽 和 象 成 员 ( 没 有 代 人 码 体 ， 且 必须 在 派生 类 中 实现 ， 否 则 派生 类 本 号 必须 也 是 抽象 的 ) 和 非 抽 
象 成 员 ( 它 们 拥有 代码 体 ， 也 可 以 是 虚拟 的 ， 这 样 束 可 以 在 派生 类 中 重 写 )。 男 一 方面 ， 接 口 成 员 必 须 部 在 使 用 
接口 的 类 上 实现 一 一 它们 没有 代码 体 。 男 外 ， 按 照 定 义 ， 接 口 成 员 是 公共 的 (因为 它们 的 目的 是 在 外 部 使 用 )， 


实际 上 ， 使 用 NET Framework 中 
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但 抽象 类 的 成 员 可 以 是 私有 的 (只 要 它们 不 是 抽象 的 )、 受 保护 的 、 内 部 的 或 受 保护 的 内 部 成 员 ( 其 中 受 保护 的 内 
部 成 员 只 能 在 应 用 程序 的 代码 或 派生 类 中 访问 )。 此 外 ， 接 口 不 能 包 售 字段、 构造 图 数 、 析 构 函 数 、 静 态 成 员 或 


T6 E. 

注意 : 

抽象 类 主要 用 作对 和 象 系列 的 基 类 ， 这 些 对 和 象 共 享 某 些 主要 特性 ， 例 如 共同 的 目的 和 结构 。 接 口 则 主要 用 于 
类 ， 这 些 类 存在 根本 性 的 区 别 ， 但 仍 可 以 完成 某 些 相同 的 任务 。 

例如 ， 假 定 有 一 个 对 象 系列 表示 火车 ， 基 类 Train 包含 火车 的 核心 定义 ， 例 如 车 轮 的 规格 和 引擎 的 类 型 (可 
以 是 节 汽 发 动机 、 岂 油 发 动机 等 )。 但 这 个 类 是 抽象 的 ， 因 为 并 没有 “一 般 的 ”火车 。 为 创建 一 辆 实际 的 火车 ， 


MEAE E. e, IREE, PAn PassengerTrain. FreightTrain 和 424DoubleBogey 等 ， 如 网 
9-11 FAN. 


Passenger Irain 


图 9-11 


也 可 以 用 相同 的 方式 来 定义 汽车 对 象 系列 ， 使 用 Car 抽象 基 类 ， 其 派生 类 有 Compact. SUV 和 PickUp. 
Car 和 Tain 甚至 可 以 派生 于 一 个 相同 的 基 类 Vehicle, nd 9-12 所 示 。 


Train 


TA 


SUV FreightTrain| |424DoubleBogey 
CUT I AU. SEN“ n S 


图 9-12 


现在 ， 层 次 结构 中 的 一 些 类 共 圣 相同 的 特性 ， 这 是 因为 它们 的 目的 是 相同 的 ， 而 不 只 是 因为 它们 派生 
于 同一 个 基 类 。 例 如 ，PassengerIraim、Compact、SUV 和 Pickup 都 可 以 运送 乘客 ， 所 以 它们 都 拥有 
IPassengerCarrier #1. FreightTrain 和 Pickup 可 用 于 重 载运 输 ， 所 以 它们 都 拥有 IHeavyLoadCarrier 接口 ， 如 
图 9-13 所 示 。 
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«Interface» «Interface» 
IPassengerCarrier IHeavyLoadCarrier 


图 9-13 


在 进行 更 详细 的 分 解 之 前 , 把 对 象 系 统 以 这 种 方式 进行 分 解 , 可 以 清晰 地 看 到 哪 种 情形 适合 使 用 抽象 类 ， 
哪 种 情形 适合 使 用 接口 。 只 使 用 接口 或 只 使 用 抽象 继承 ， 束 得 不 到 这 个 示例 的 结果 。 


97 ”结构 类 型 


第 8 草 提 到 过 ， 绪 构 和 类 非常 相似 ， 但 结构 是 值 类 型 ， 而 类 是 引用 类 型 。 这 意味 独 什 么 ? 最 简明 的 方式 是 
用 一 个 示例 来 说 明 ， 如 下 面 的 示例 所 示 。 


试 一 试 ”类 和 结构 : ChO9Ex03\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter09 目录 中 创建 一 个 新 的 控制 台 应 用 程序 项 目 Ch09Ex03。 
(2) 修改 代码 ， 如 下 所 示 : 


namespace Ch09Ex03 
{ 
class MyClass 
{ 
public int val; 
} 
struct myStruct 
{ 
public int val; 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
MyClass objectA = new MyClass(); 
MyClass objectB = objectA; 
objectA.val = 10; 
objectB.val = 20; 
myStruct structA = new myStruct(); 
myStruct structB = structA; 
structA.val = 30; 
structB.val = 40; 
WriteLine($"objectA.val 
WriteLine ($"objectB.val 
WriteLine($"structA.val 
WriteLine ($"structB.val 
ReadRKey () ; 


(objectA.val)"); 
{objectB.val}"); 
[structA.val)"); 
{structB.val}"); 
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} 
} 


(3) 运行 应 用 程序 ， 结 果 如 图 9-14 所 示 。 


9-14 


示例 说 明 

这 个 应 用 程序 包含 两 个 类 型 定义 ;一 个 是 结构 myStruct 的 定义 ， 它 有 一 个 公共 int 字段 val; 另 一 个 是 类 
MyClass 的 定义 ， 它 包含 一 个 相同 的 字段 (第 10 和 章 介 绍 类 的 成 员 ， 如 字段 ， 现 在 只 要 知道 它们 的 语法 是 相同 的 
即 可 )。 接 着 对 这 两 种 类 型 的 实例 执行 相同 的 操作 : 

(1) 声明 类 型 的 一 个 变量 。 

(2) 在 这 个 变量 中 创建 该 类 型 的 新 实例 。 

(3) 声明 类 型 的 第 二 个 变量 。 

(4) 将 第 一 个 变量 赋 给 第 二 个 变量 。 

(5) 在 第 一 个 变量 的 实例 中 ， 给 val 字段 赋予 一 个 值 。 

(6) 在 第 二 个 变量 的 实例 中 ， 给 val 字段 赋予 一 个 值 。 

(7) 显示 这 两 个 变量 的 val 字段 值 。 

尽管 对 这 两 种 类 型 的 变量 执行 了 相同 的 操作 ， 但 结果 是 不 同 的 。 在 显示 val 字段 的 值 时 ， 两 个 object 2570 H. 
有 相同 的 值 ， 而 结构 类 型 有 不 同 的 值 。 为 什么 会 这 样 ? 

对 销 是 引用 类 型 。 把 对 象 赋 给 变量 时 ， 实 际 上 是 把 之 有 一 个 指针 的 变量 赋 给 了 该 指针 所 指 同 的 对 象 。 在 实 
际 代 码 中 ， 指 针 是 内 存 中 的 一 个 地 址 。 这 种 情况 下 ， 地 址 是 内 存 中 该 对 象 所 在 的 位 置 。 用 下 面 的 代码 行 把 第 一 
个 对 象 引 用 赋 给 类 型 为 MyClass 的 第 二 个 变量 时 ， 实 际 上 是 复制 了 这 个 地 址 。 


MyClass objectB = objectA; 


XX EET 4] AE tL HARRE. 
结构 是 值 类 型 。 其 变量 并 不 是 包含 结构 的 指针 ， 而 是 包含 结构 本 映 。 在 用 下 面 的 代码 把 第 一 个 结构 赋 给 类 
型 为 myStruct 的 第 二 个 变量 时 ， 实 际 上 是 把 第 一 个 结构 的 所 有 信息 复制 到 第 二 个 结构 中 。 


myStruct structB = structA; 


这 个 过 程 与 本 书 前 面 介绍 的 简单 变量 类 型 (如 in 是 一 样 的 ,最 终结 果 是 两 个 结构 类 型 变量 包含 不 同 的 结构 。 
使 用 指针 的 全 部 技术 隐藏 在 托管 C# 代 码 中 ， 这 使 得 代码 更 简单 。 使 用 C# 中 的 不 安全 代码 可 以 执行 低级 操作 ， 
如 指针 操作 ， 但 这 是 一 个 比较 局 级 的 主题 ， 这 里 不 子 讨论 。 


98 浅 度 和 深度 复制 


从 一 个 变量 到 另 一 个 变量 按 值 复制 对 象 ， 而 不 是 按 引用 复制 对 象 ( 即 以 与 结构 相同 的 方式 复制 ) 可 能 非常 复 
沫 。 因 为 一 个 对 象 可 能 包 舍 许 多 其 他 对 象 的 引用 ， 例 如 字段 成 员 等 ， 这 将 涉及 许多 票 录 的 处 理 。 把 每 个 成 员 从 
一 个 对 象 复制 到 男 一 个 对 象 中 可 能 不 会 成 功 ， 因 为 其 中 一 些 成 员 可 能 是 引用 类 型 。 

NET Framework 考虑 了 这 个 问题 。 简 单 地 按照 成 员 复 制 对 象 可 以 通过 派生 于 System.Object 的 
MemberwiseClone0 方 法 来 完成 ， 这 是 一 个 受 保护 的 方法 ， 但 很 容易 在 对 象 上 定义 一 个 调用 该 方法 的 公共 方法 。 这 个 
方法 提供 的 复制 功能 称 为 浅 度 复制 (shallow copy)， 因 为 它 并 未 考虑 引用 类 型 成 员 。 因 此 ， 新 对 象 中 的 引用 成 员 就 会 
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指向 源 对 象 中 相同 成 员 引 用 的 对 象 ， 在 许多 情况 下 这 并 不 理想 。 如 果 要 创建 成 员 的 新 实例 (复制 值 ， 而 不 复制 引用 )， 
此 时 需要 使 用 深度 复制 (deep copy)。 

可 以 实现 一 个 ICloneable 接口 ， 以 标准 方式 进行 深度 复制 。 如 果 使 用 这 个 接口 ， 就 必须 实现 它 包含 的 Clone0 方 
法 。 这 个 方法 返回 一 个 类 型 为 System.Object 的 值 。 我 们 可 以 采用 各 种 处 理 方式 ， 实 现 所 选 的 任何 一 个 方法 体 来 得 到 
这 个 对 象 。 如 果 愿 意 ， 就 可 以 进行 深度 复制 (但 不 是 必须 执行 深度 复制 ， 所 以 如 果 执 行 浅 度 复制 更 合适 ， 就 可 以 执行 
浅 度 复制 )。 对 于 该 方法 应 该 返回 什么 ， 并 不 存在 规则 或 限制 ， 所 以 很 多 人 建议 不 要 使 用 它 。 这 些 人 建议 实现 自 
己 的 深度 复制 方法 。 第 11 章 将 详细 介绍 这 个 接口 。 


9.9 ”习题 
(1) 下 面 的 代码 存在 什么 错误 ? 


public sealed class MyClass 


// Class members. 


} 
public class myDerivedClass : MyClass 


| // Class members. 

(2) 如 何 定义 不 能 创建 的 类 (non-creatable class)? 

(3) 为 什么 不 能 创建 的 类 仍旧 有 用 ? 如 何 利用 它们 的 功能 ? 

(4) 在 类 库 项 目 Vehicles 中 编写 代码 ， 实 现 本 间 前 面 讨论 的 Vehicle 对 象 系列 ， 其 中 有 9 个 对 象 和 两 个 接口 
需要 实现 。 

(5) 创建 一 个 控制 台 应 用 程序 项 目 Traffic, € 51H Vehicles.dll( 在 习题 (4) 中 创建 )， 其 中 包括 函数 
AddPassenger()， 它 接受 任何 市 有 IPassengerCarrier 接口 的 对 象 。 要 证 明代 码 可 以 运行 ， 使 用 文 持 这 个 接口 的 每 
个 对 象 实例 调用 该 函数 ， 在 每 个 对 象 上 调用 派生 于 System.Object 的 ToString0 方 法 ， 并 将 结果 输出 到 屏幕 上 。 


附录 A 给 出 了 习题 答案 。 
910 ARES 
= Es] = 点 


类 用 class 关键 字 定 义 ， 接 口 用 interface 关键 字 定 义 。 可 以 使 用 public 和 internal 关键 字 来 定义 类 和 接口 的 可 
类 和 接口 定义 访问 性 ， 类 可 以 定义 为 abstract 或 sealed， 以 便 控制 继承 性 。 父 类 和 父 接口 在 一 个 用 逗号 分 隔 的 列表 中 指定 ， 

放 在 类 或 接口 名 和 一 个 冒号 的 后 面 。 在 类 定义 中 ， 只 能 指定 一 个 父 类 ， 且 必须 是 列表 中 的 第 一 项 

类 自动 带 有 默认 的 构造 函数 和 析 构 函数 的 实现 代码 ,我 们 很 少 需要 提供 自己 的 析 构 函数 。 可 以 使 用 可 访问 性 、 


€ — 类 名 和 可 能 需要 的 任何 参数 来 定义 构造 函数 。 基 类 的 构造 函数 在 派生 类 的 构造 函数 之 前 执行 , 使 用 this 和 base 
构造 函数 初始 化 器 关键 字 ， 可 以 控制 类 中 这 些 构 造 函 数 的 执行 顺序 

- 可 以 创建 只 包含 类 定义 的 类 库 项 目 ,这 些 项 目 不 能 直接 执行 , 而 必须 通过 客户 代码 在 可 执行 程序 中 访问 。Visual 
Studio 为 创建 、 修 改 和 测试 类 提供 了 各 种 工具 

类 系列 类 可 以 组 合 为 系列 ， 以 提供 公共 的 操作 或 共享 公共 特性 。 为 此 ， 可 从 共享 的 基 类 (可 以 是 抽象 的 ) 中 继承 ， 或 者 
实现 接口 

结构 定义 结构 的 定义 方式 与 类 非常 类 似 ， 但 结构 是 值 类 型 ， 而 类 是 引用 类 型 

wine 复制 对 象 时 ， 必 须 注意 应 复制 该 对 象 包含 的 其 他 对 象 ， 而 不 是 仅 复制 这 些 对 象 的 引用 。 复 制 引用 称 为 浅 度 复 


制 ， 而 完全 复制 称 为 深度 复制 。 可 将 ICloneable 接口 用 作 一 个 框架 ， 提 供 类 定义 中 的 深度 复制 功能 


REAR: 

如 何 定 义 类 成 员 

如 何 控制 类 成 员 的 继承 

fm FE LKB INA 

如 何 实现 接口 

如 何 使 用 部 分 类 定义 

如 何 使 用 Call Hierarchy 窗口 


本 章 源 代码 可 以 通过 本 书 合作 站 点 Wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapter10 文件 夹 中 并 已 根据 本 章 示例 的 名 称 
单独 命名 。 


本 章 继续 讨论 在 c# 中 如 何 定义 类 ,主要 介绍 的 是 如 何 定义 字段 、 属 性 和 方法 等 类 成 员 。 首 先 介绍 每 种 类 型 
需要 的 代码 ， 以 及 如 何 生成 相应 代码 的 结构 。 还 将 论述 如 何 通过 编辑 成 员 的 属性 ， 来 快速 修改 这 些 成 员 。 

介绍 完成 员 定 义 的 基础 知识 后 ， 将 讨论 一 些 比较 高 级 的 成 员 技 术 : 隐藏 基 类 成 员 ， 调 用 重 写 的 基 类 成 员 、 
嵌 套 的 类 型 定义 和 部 分 类 定义 。 

最 后 将 理论 付 诸 实践 ， 创 建 一 个 类 库 ， 以 便 在 后 续 章节 中 使 用 它 。 


10.1 REX 


FRE, Eht ERFAR EX BHR. MAMBE. MARRA A CAII HRA], 
用 下 和 面 的 关键 字 之 一 来 定义 : 

e public 一 一 成 员 可 以 由 任何 代码 访问 。 

e private 一 一 成 员 只 能 由 类 中 的 代码 访问 (如 果 没 有 使 用 任何 关键 字 ， 就 默认 使 用 这 个 关键 字 )。 

e ”internal 一 一 成 员 只 能 由 定义 它 的 程序 集 (项 目 ) 内 部 的 代码 访问 。 

e protected 一 一 成 员 只 能 由 类 或 派生 类 中 的 代码 访问 。 
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后 两 个 关键 字 可 以 结合 使 用 ， 所 以 也 有 protected internal 成 员 。 它 们 只 能 由 项 目 ( 更 确切 地 讲 ， 是 程序 集 ) 中 


派生 类 的 代码 来 访问 。 


也 可 以 使 用 关键 字 static 来 声明 字段 、 方 法 和 属性 ， 这 表示 它们 是 类 的 静态 成 员 ， 而 不 是 对 象 实 例 的 成 员 ， 


TEILE 8 章 。 


10.1.1 定义 字段 


用 标准 的 变量 声明 格式 (可 以 进行 初始 化 ) 和 前 面 介绍 的 修饰 符 来 定义 字段 ， 例 如 : 
class MyClass 


public int MyInt; 


} 


NET Framework 中 的 公共 字段 以 PascalCasing 形式 来 命名 ， 而 不 是 camelCasing。 这 里 使 用 的 就 是 这 种 大 小 写 形 
所 以 上 面 的 字段 名 为 MyInt 而 不 是 myInt。 这 仅 是 推荐 使 用 的 一 种 名 称 大 小 写 形式 ， 但 它 的 意义 非常 重大 。 


私有 字段 没有 推荐 的 名 称 大 小 写 模式 ， 它 们 通常 使 用 camelCasing 来 命名 。 


字段 也 可 以 使 用 关键 学 readonly, 表示 这 个 字段 只 能 在 执行 构造 函数 的 过 程 中 赋值 , 或 由 初始 化 赋值 语句 赋 


。 例 如 : 


class MyClass 
{ 


public readonly int MyInt = 17; 
} 


如 本 章 开头 所 述 ， 可 使 用 static 关键 字 将 字段 声明 为 静态 字段 ， 例 如 : 
class MyClass 


public static int MyInt; 
} 


静态 字段 必须 通过 定义 它们 的 类 来 访问 (在 上 面 的 示例 中 ， 是 MyClass.MyInb， 而 不 是 通过 这 个 类 的 对 象 实 


例 来 访问 。 男 外 ， 可 使 用 关键 字 const 来 创建 一 个 当量 值 。 按 照 定 义 ，const 成 员 也 是 静态 的 ， 所 以 不 需要 使 用 
static 修饰 符 ( 实 际 上 ， 使 用 static 修饰 符 会 产生 一 个 错误 )。 


10.1.2 定义 方法 


方法 使 用 标准 函数 格式 、 可 访问 性 和 可 选 的 static 修饰 从 来 声明 。 例 如 : 
class MyClass 


{ 
public string GetString() => "Here is a string."; 
} 


注意 : 
与 公共 字段 一 样 ， NET Framework 中 的 公共 方法 也 采用 PascalCasing 形式 来 命名 。 


注意 ， 如 果 使 用 了 static 关键 字 ， 这 个 方法 就 只 能 通过 类 来 访问 ， 不 能 通过 对 象 实例 来 访问 。 也 可 以 在 方法 


定义 中 使 用 下 述 关 键 字 : 


e virtual 一 一 方法 可 以 重 写 。 

e abstract — PADME FARRER A Ss OAH FRAP). 

e override — WEES f — MERA MATER ES, SUD AE HABET). 
e extern 一 一 方法 定义 放 在 其 他 地 方 。 

以 下 是 方法 重 写 的 一 个 示例 ; 


public class MyBaseClass 
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{ 
public virtual void DoSomething () 
{ 
// Base implementation. 


} 
public class MyDerivedClass : MyBaseClass 
{ 

public override void DoSomething () 


// Derived class implementation, overrides base implementation. 
} 
} 


如 果 使 用 了 override， 也 可 以 使 用 sealed 来 指定 在 派生 类 中 不 能 对 这 个 方法 做 进一步 的 修改 ， 即 这 个 方法 不 
能 由 派生 类 和 草 写 。 例 如 : 


public class MyDerivedClass : MyBaseClass 
{ 
public override sealed void DoSomething() 
i 
// Derived class implementation, overrides base implementation. 
} 
} 


使 用 extern 可 在 项 目 外 部 提供 方法 的 实现 代码 。 这 十 一 个 局 级 论题 ， 这 里 不 做 详细 讨论 。 
10.13 定义 属性 


属性 的 定义 方式 与 字段 类 似 ， 但 包含 的 内 容 比较 多 。 如 前 所 述 ， 属 性 比 字段 复杂 ， 因 为 它们 在 修改 状态 前 
还 可 以 执行 一 些 颌 外 操作 ， 实 际 上 ， 它 们 可 能 并 不 修改 状态 。 属 性 拥有 两 个 类 似 于 函数 的 块 ， 一 个 块 用 于 获取 
属性 的 值 ， 男 一 个 块 用 于 设置 属性 的 值 。 

这 两 个 块 也 称 为 访问 器 ， 分 别 用 get 和 set 关键 字 来 定义 ， 可 以 用 于 控制 属性 的 访问 级 别 。 可 以 忽略 其 中 的 
一 个 块 来 创建 只 读 或 只 写 属 性 (忽略 get 块 创 建 只 与 属性 ， 忽 略 set 块 创建 只 读 属 性 )。 当 然 ， 这 仅 适 用 于 外 部 代 
码 ， 因 为 类 中 的 其 他 代码 可 以 访问 这 些 代码 块 能 访问 的 数据 。 还 可 以 在 访问 占 上 包含 可 访问 修饰 牺 , 例如 使 get 
块 变 成 公共 的 ， 使 set 块 变 成 受 保护 的 。 至 少 要 包含 其 中 一 个 块 ， 属 性 才 是 有 效 的 ( 既 不 能 读 取 也 不 能 修改 的 属 
性 没有 任何 用 处 )。 

属性 的 基本 结构 包括 标准 的 可 访问 修饰 符 (public、private 等 )， 后 跟 类 型 名 、 属 性 名 和 get 块 (或 set HR, Bk 
者 get RAI set 块 ， 其 中 包含 属性 处 理 代码 )， 例 如 : 

public int MyIntProp 


i 
get 


{ 
// Property get code. 
set 


{ 
// Property set code. 
} 


| 


注意 : 
NET 中 的 公共 属性 也 以 PascalCasing 方式 来 命名 ， 而 不 是 camelCasing 方式 命名 ， 与 字段 和 方法 一 样 ， 这 
里 使 用 PascalCasing 方式 。 


定义 中 的 第 一 行 代 码 非常 类 似 于 定义 字段 的 代码 。 区 别 在 于 行 末 没有 分 号 ， 而 是 一 个 包含 嵌 套 get 和 set 
块 的 代码 块 。 

get 块 必须 有 一 个 属性 类 型 的 返回 值 , 简单 属性 一 般 与 私有 字段 相关 联 ， 以 控制 对 这 个 字段 的 访问 ,此 时 get 
块 可 以 直接 返回 该 字段 的 值 ， 例 如 : 


// Field used by property. 
private int myInt; 


160 | 第 1 部 分 CH BE 


// Property. 
public int MyIntProp 
{ 
get [ return myInt; } 
set { // Property set code. } 
} 
关外 部 的 代码 不 能 直接 访问 这 个 myInt 字段 ， 因 为 其 访问 级 别 是 私有 的 。 外 部 代码 必须 使 用 属性 来 访问 该 
字段 。set 国 数 采用 类 似 方 式 把 一 个 值 赋 给 字段 。 这 里 可 使 用 关键 字 value 来 表示 用 户 提供 的 属性 值 : 
// Field used by property. 
private int myInt; 
// Property. 
public int MyIntProp 
{ 
get { return myInt; } 


set { myInt = value; |] 
} 


value 等 于 类 型 与 属性 相同 的 一 个 值 ， 所 以 如 果 属 性 和 字段 使 用 相同 的 类 型 ， 就 不 必 考 虑 数据 类 型 转换 了 。 
要 为 可 空 整数 类 型 提供 一 个 默认 值 ， 可 以 使 用 这 个 由 表达 式 构成 的 成 员 函 数 模 式 。 
private int? myInt; 
public int? MyIntProp 
i get { return myInt; } 
set | myInt = value ?? 0; | 
} 
这 个 简单 属性 只 是 用 来 阻止 对 myInt 字段 的 直接 访问 。 在 对 操作 进行 更 多 控制 时 ， 属 性 的 真正 作用 才能 发 
挥 出 来 。 例 如 ， 使 用 下 面 的 代码 实现 set H: 
Set 
if (value >= 0 && value <= 10) 
myInt = value; 


} 
只 有 赋 给 属性 的 值 在 0-10 之 间 ， 才 会 修改 myInt。 此 时 ， 要 做 一 个 重要 的 设计 选择 : 如 果 使 用 了 无 效 值 ， 
该 怎么 办 ? 有 4 种 选择 : 


e 什么 也 不 做 (如 上 述 代码 所 示 )。 

e 给 字段 赋 默 认 值 。 

e AAT, BRR ERK, (ide PAs, We RRM. 
e JHE. 


一 般 情况 下 ， 后 两 个 选择 效果 较 好 ， 选 择 哪个 选项 取决 于 如 何 使 用 类 ， 以 及 给 类 的 用 户 授 予 多 少 控制 权 。 
抛 出 异 沼 给 用 尸 提供 的 控制 权 相 当 大 ， 可 以 让 他 们 了 解 友 生 了 什么 情况 ， 并 做 适当 的 啊 应 。 为 此 可 使 用 System 
名 称 空间 中 的 标准 异 弟 ， 例 如 : 
set 
{ 
if (value >= 0 && value <= 10) 
myInt = value; 
tm (new ArgumentOutOfRangeException("MyIntProp", value, 
"MyIntProp must be assigned a value between 0 and 10.")); 
} 
该 异常 可 在 使 用 属性 的 代码 中 通过 try...catch...finally 逻辑 加 以 处 理 ， 详 见 第 7 章 。 
记录 数据 (例如 记录 到 文本 文件 中 或 Event Log 中 ) 比 较 有 效 ， 例 如 可 用 在 不 应 出 错 的 产品 代码 中 。 它们 允许 
开发 人 员 检 碍 性 能 ， 如 有 必要 ， 还 可 以 调试 现 有 的 代码 。 
属性 可 以 使 用 virtual, override 和 abstract 关键 字 ， 融 像 方法 一 样 ， 但 这 几 个 关键 字 不 能 用 于 字段 。 了 最 后 ， 
如 上 所 述 ， 访 问 右 可 以 有 目 己 的 可 访问 性 ， 例 如 : 
// Field used by property. 
private int myInt; 


// Property. 
public int MyIntProp 
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{ 
get { return myInt; } 
protected set | myInt = value; } 
} 


只 有 类 或 派生 类 中 的 代码 才能 使 用 set 访问 器 。 
访问 器 可 以 使 用 的 访问 修饰 符 取 决 于 属性 的 可 访问 性 , 访问 器 的 可 访问 性 不 能 高 于 它 所 属 的 属性 , 也 就 是 说 
私有 属性 对 它 的 访问 器 不 能 包含 任何 可 访问 修饰 符 ， 而 公共 属性 可 以 对 其 访问 器 使 用 所 有 的 可 访问 修饰 符 。 
C#6 引入 了 一 个 名 为 “基于 表达 式 的 属性 ”的 功能 。 类 似 于 第 6 章 讨论 的 基于 表达 式 的 方法 ， 这 个 功能 可 以 
把 属性 的 定义 减少 为 一 行 代码 。 例 如 ， 下 面 的 属性 对 一 个 值 进行 数学 计算 ， 可 以 使 用 Lambda 箭头 后 跟 等 式 来 
定义 : 


// Field used by property. 

private int myDoubledInt - 5; 

// Property. 

public int MyDoubledIntProp => (myDoubledInt * 2); 


下 面 的 示例 将 定义 和 使 用 字段 、 方 法 和 属性 。 


试 一 试 “使 用 字段 、 方 法 和 属性 : Ch10Ex01 


(1) 在 C:\BeginningCSharp7\Chapter10 目录 中 创建 一 个 新 控制 台 应 用 程序 Ch10Ex01 . 
(2) 使 用 Add Class 快捷 方式 添加 一 个 新 类 MyClass， 这 将 在 新 文件 MyClass.cs 中 定义 这 个 新 类 。 
(3) 修改 MyClass.cs 中 的 代码 ， 如 下 所 示 : 


public class MyClass 
{ 

public readonly string Name; 
private int intVal; 
public int Val 
{ 

get { return intVal; } 

set { 

if (value >= 0 && value <= 10) 
intVal = value; 
else 
throw (new ArgumentOutOfRangeException("Val", value, 
"Val must be assigned a value between 0 and 10.")); 

} 
} 
public override string ToString() => "Name: " + Name + "\nVal: " + Val; 
private MyClass() : this("Default Name") { } 
public MyClass(string newName) 
{ 

Name = newName; 

intVal = 0; 
} 
private int myDoubledInt = 5; 
public int myDoubledIntProp => (myDoubledInt * 2); 


} 
(4) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using static System.Console; 
static void Main(string[] args) 
{ 
WriteLine ("Creating object myObj..."); 
MyClass myObj = new MyClass("My Object"); 
WriteLine("myObj created."); 
for (int i = -1; i <= 0; i++) 
{ 
try 
{ 
WriteLine ($"\nAttempting to assign {i} to myObj.Val..."); 
myObj.Val = i; 
WriteLine($"Value (myObj.Val) assigned to myObj.Val."); 


catch (Exception e) 

t 
WriteLine($"Exception {e.GetType().FullName} thrown."); 
WriteLine ($"Message: \n\"{e.Message}\"") ; 

} 
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} 

WriteLine("MnOutputting myObj.ToString()..."); 

WriteLine (myObj.ToString()); 

WriteLine("myObj.ToString() Output."); 

WriteLine("MnmyDoubledIntProp = 5..."); 

WriteLine($"Getting myDoubledIntProp of 5 is (myObj.myDoubledIntProp)"); 


ReadKey () ; 
) 
(5) 运行 应 用 程序 ， 其 结果 如 图 10-1 所 示 。 
LE 


mmr 


图 10-1 


示例 说 明 
Main0 中 的 代码 创建 并 使 用 在 MyClass.cs 中 定义 的 MyClass 关 的 实例 。 实 例 化 这 个 类 必须 使 用 非 默 认 的 构 
造 图 数 来 进行 ， 因 为 MyClass 类 的 默认 构造 图 数 是 私有 的 : 


private MyClass() : this("Default Name") {} 


注意 ， 这 里 用 this("Default Name") 来 保证 ， 如 果 调 用 了 该 构造 函数 ，Name 束 获 取 一 个 什 。 如 果 这 个 类 用 于 
派生 一 个 新 类 ， 这 就 是 可 能 的 。 必 须 这 么 做 ， 因 为 不 给 Name 字段 赋值 ， 束 会 在 后 面 产生 错误 。 

所 使 用 的 非 默 认 构 造 函 数 把 值 赋 给 只 读 字 段 Name( 只 能 在 字段 声明 或 在 构造 函数 中 给 它 赋 值 ) 和 私有 字段 
intVal. 

接着 , Main0 试 着 给 myObj(MyClass 的 实例 ) 的 Val 属性 两 次 赋值 。 使 用 for 循环 在 两 次 迭代 中 赋值 1 1 和 0 
使 用 try...catch 结构 检查 抛 出 的 任何 异 利 。 把 - 1 赋 给 属性 时 ， 会 抛 出 System.ArgumentOutOfRangeException X 
型 的 异常 ，eatch 块 中 的 代码 会 把 该 异常 的 信息 输出 到 控制 台 窗口 中 。 在 下 一 个 循环 中 ， 值 0 成 功 地 赋 给 Val JR 
性 ， 通 过 这 个 属性 再 把 值 赋 给 私有 字段 intVal。 

最 后 ， 使 用 重 写 的 ToString0 方 法 输出 一 个 格式 化 的 字符 串 ， 来 表示 对 和 象 的 内 容 : 

public override string ToString() => "Name: " + Name + "\nVal: " + Val; 

必须 使 用 override 关键 字 来 声明 这 个 方法 ， 因 为 它 重 写 了 基 类 System.Object 的 虚拟 方法 ToString(). JAN 
代码 直接 使 用 属性 Val， 而 不 是 私有 字段 ntVal。 没 理由 不 以 这 种 方式 使 用 类 中 的 属性 ， 但 这 可 能 会 对 性 能 产生 
轻微 影响 (对 性 能 的 影 啊 非 党 小， 我 们 不 会 察 沉 人)。 当 然 ， 使 用 属性 也 可 以 在 属性 中 进行 固有 的 有 效 性 验证 ， 
这 对 类 中 的 代码 也 是 有 好 处 的 。 

最 后 在 MyClass.cs 中 创建 只 读 属 性 myDoubledInt 并 设置 为 5。 使 用 基于 表达 式 的 属性 功能 ， 返 回 乘 以 2 后 
的 值 : 


public int MyDoubledIntProp => (myDoubledInt * 2); 


当 使 用 myObj.myDoubledIntProp 访问 属性 时 ， 输 出 结果 是 2 乘 以 5 的 积 ， 即 10， 与 预期 相符 。 
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10.1.4 元 组 析 构 


第 6 章 中 介绍 了 元 组 ， 它 对 于 从 一 个 函数 中 返回 多 个 结果 非常 有 用 。 对 于 没有 必要 使 用 更 复杂 的 对 象 ， 如 
类 、 结 构 或 数组 这 类 情况 ， 使 用 元 组 惑 非 党 有效。 下面 是 一 个 有 关 元 组 的 和 侧 单 示例 : 

var numbers = (1, 2, 3, 4, 5); 

该 示例 定义 了 一 个 返回 多 个 结果 的 图 数 : 


private static (int max, int min, double average) 
GetMaxMin (IEnumerable<int> numbers) {...} 


通过 代码 调用 GetMaxMin0 AAT, 返回 的 结果 必须 由 代码 解析 后 才能 显示 ( 右 需 要 重 温 一 下 具体 的 实现 方 
法 ， 请 参阅 第 6 章 )。 如 果 可 以 实现 元 组 析 构 (tuple deconstruction)， 就 没有 必要 编写 解析 结果 的 代码 。 要 实现 元 
组 析 构 ， 只 需要 给 文 持 该 特性 的 任何 类 添加 Deconstract0 函 数 即 可 ， 如 下 面 的 类 所 示 : 


public class Location 
{ 
public Location(double latitude, double Longitude) 
=> (Latitude, Longitude) = (latitude, longitude); 


public double Latitude { get; } 
public double Longitude { get; } 


public void Deconstruct (out double latitude, out double longitude) 


=> (latitude, longitude) = (Latitude, Longitude); 
} 


Location 类 实现 了 一 个 表达 式 体 (expression-bodied) 构 造 器 ， 它 接受 类 型 为 double 的 两 个 变量 (latitude 和 
longitude)， 用 于 设置 属性 Latitude 和 Longitude [48 . Deconstruct() Fi TIUS WA out 参数 : out double latitude 和 
out double longitude。 表 达 式 将 这 两 个 out 参数 的 值 分 别 设置 为 初始 化 Location 类 时 Latitude 和 Longitude 属性 
的 填充 值 。 可 通过 将 元 组 赋 给 Location 的 方法 来 访问 这 两 个 字段: 


var location = new Location(48.137154, 11.576124); 
(double latitude, double longitude) = location; 
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10.1.5 ” 重 构 成 员 


在 添加 属性 时 有 一 项 很 方便 的 技术 ， 可 以 从 字段 中 生成 属性 。 下 面 是 一 个 重 构 (refactoring) 的 示例 ,，“ 重 构 ” 
表示 使 用 工具 修改 代码 ， 而 不 是 手动 修改 。 为 此 ， 只 需要 右 击 类 图 中 的 某 个 成 员 ， 或 在 代码 视图 中 右 击 某 个 成 
员 即 可 。 

例如 ， 如 果 MyClass 类 包含 如 下 字段 : 


public string myString; 


右 击 该 字段 ， 选 择 Quick Actions and Refactorings...(Ctrl 十 )， 就 会 打开 如 图 10-2 所 示 的 对 话 框 。 


private string myString; 


public string MyString 
t 


get -» myString; 
} set => myString = value; 


} 


Preview changes 


到 10-2 


EZANA, Mae MyClass 的 代码 ， 如 下 所 示 : 


public string myString; 
public string MyString 
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i get => myString; 
set => myString = value; 
private string myString; 
myString 字段 的 可 访问 性 已 变 成 private; 同时 创建 了 一 个 公共 属性 MyString, 它 目 动 链 接 到 myString E- 
显然 ， 这 会 减少 为 字段 创建 属性 所 再 的 时 间 。 


10.4.6 自动 属性 


属性 是 访问 对 象 状 态 的 自选 方式 , 因为 它们 禁止 外 部 代码 访问 对 象 内 部 的 数据 存储 机 制 的 实现 。 属性 还 对 内 
部 数据 的 访问 方式 施加 了 更 多 控制 ， 本 间 代 码 在 多 处 体现 了 这 一 点 。 但 是 ， 一 般 以 非常 标准 的 方式 定义 属性 ， 
即 通 过 一 个 公共 属性 来 直接 访问 一 个 私有 成 员 。 其 代码 非 弟 类 似 于 上 一 市 的 代码 ， 这 是 Visual Studio 重 构 工 具 
目 动 生成 的 。 

重 构 功能 肯定 加 快 了 键入 速度 ， 不 过 除 此 以 外 ，C# 态 外 提供 了 一 种 方式 : 目 动 属性 。 对 于 目 动 属性 ， 可 以 
用 简化 的 语法 声明 属性 ，C# 编 译 右 会 日 动 添 加 未 键入 的 内 容 。 确 切 地 讲 ， 编 译 右 会 声明 一 个 用 于 存储 属性 的 私 
有 字段 ， 并 在 属性 的 get 和 set 块 中 使 用 该 字段 ， 我 们 不 必 考 虑 细 证 。 

使 用 下 面 的 代码 结构 就 可 以 定义 一 个 日 动 属性 : 

public int MyIntProp 

get; 

set; 

} 

甚至 可 在 一 行 代码 上 定义 目 动 属性 ， 以 便 节 省 空间 ， 而 不 会 过 度 地 降低 属性 的 可 读 性 : 

public int MyIntProp { get; set; } 

我 们 按照 通 弟 的 方式 定义 属性 的 可 访问 性 、 类 型 和 名 称 ， 但 没有 给 get 或 set 块 提 供 实现 代码 。 这 些 块 的 实 
现代 码 (和 奔 层 的 字段 ) 部 由 编 详 如 提供 。 


注意 : 
使 用 Visual Studio 中 的 支持 代码 片段 ， 可 以 创建 一 个 自动 实现 的 属性 模板 。 输入 prop 后 按 Tab 键 两 次 ， 就 
会 自动 创建 public int MyProperty (get; set; . 
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段 的 名 称 (该 名 称 是 在 编 诺 期 间 定 义 的 )。 但 这 并 不 是 一 个 真正 意义 上 的 限制 ， 因 为 可 以 直接 使 用 属性 名 。 目 动 
属性 的 唯一 限制 是 它们 必须 包含 get 和 set 访问 器 ， 无 法 使 用 这 种 方式 定义 只 读 或 只 写 属 性 。 但 可 以 改变 这 些 
访问 器 的 可 访问 性 。 例 如 ， 可 采用 如 下 方式 创建 一 个 外 部 只 读 属性 ; 

public int MyIntProp { get; private set; } 

此 时 ， 只 能 在 类 定义 的 代码 中 访问 MyIntProp 的 值 。 

CH6 引入 了 两 个 与 目 动 属性 相关 的 新 概念 : 只 有 get 访问 器 的 目 动 属 性 ， 和 目 动 属性 的 初始 化 器 。 在 C# 6 
之 前 ， 上 自动 属性 需要 set 访问 器 ， 来 限制 不 变数 据 类 型 的 使 用 。 不 变数 据 类 型 的 简单 定义 是 ， 一 旦 创建 ， 就 不 
会 改变 状态 。 最 者 名 的 不 变 类 型 是 System.Strimmg。 使 用 不 变 的 数据 类 型 有 很 多 优点 ， 比 如 简化 了 并 友 编 程 和 线 
程 的 同步 。 

并 发 编程 和 线程 的 同步 是 高 级 主题 ， 本 书 不 进一步 讨论 。 然 而 一 定 要 知道 只 有 get 访问 器 的 目 动 属性 。 它 
们 使 用 以 下 语法 创建 ， 注 意 不 再 圾 要 set 访问 器: 

public int MyIntProp { get; } 

目 动 属 性 的 初始 化 功能 由 以 下 声明 字段 的 方式 实现 : 


public int MyIntProp { get; } = 9; 
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102 类 成 员 的 其 他 主题 


下 面 该 讨论 一 些 较 高 级 的 成 员 主题 了 。 本 节 主要 研究 : 
。 隐藏 基 类 方法 

。 调用 重 写 或 隐藏 的 基 类 方法 

。 使 用 说 套 的 类 型 定义 


10.2.1 隐藏 基 类 方法 


当 从 基 类 继承 一 个 ( 非 抽象 的 ) 成 员 时 , 也 就 继承 了 其 实现 代码 。 如 果 继 承 的 成 员 是 虚拟 的 , 就 可 以 用 override 
关键 字 重 写 这 段 实现 代码 。 无 论 继承 的 成 员 是 否 为 虚拟 ， 都 可 以 隐藏 这 些 实现 代码 。 这 是 很 有 用 的 ， 例 如 ， 当 
继承 的 公共 成 员 不 像 预期 的 那样 工作 时 ， 就 可 以 隐藏 它 。 

使 用 下 面 的 代码 就 可 以 隐藏: 


public class MyBaseClass 


{ 
public void DoSomething () 
{ 
// Base implementation. 
} 
} 
public class MyDerivedClass : MyBaseClass 
{ 
public void DoSomething () 
{ 
// Derived class implementation, hides base implementation. 
} 
} 


尽管 这 段 代码 可 以 正常 运行 ， 但 它 会 生成 一 个 警告 ， 说 明 隐藏 了 一 个 基 类 成 员 。 如 果 是 无 意 间 隐 藏 了 一 个 


裔 要 使 用 的 成 员 ， 此 时 就 可 以 改正 错误 。 如 果 确 实 要 隐藏 该 成 员 ， 就 可 以 使 用 new 关键 字 显 式 地 表明 意图 : 


public class MyDerivedClass : MyBaseClass 


{ 
new public void DoSomething() 
{ 
// Derived class implementation, hides base implementation. 
} 
} 


其 工作 方式 是 完全 相同 的 , [HAS LR Eo DEBE NITE Bee EX, AS ET XW). AEP 
FH: 

public class MyBaseClass 

| public virtual void DoSomething() => WriteLine("Base imp"); 


public class MyDerivedClass : MyBaseClass 
{ 


} 
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行 的 ， 情 况 也 同样 如 此 (使 用 多 态 性 ): 

MyDerivedClass myObj = new MyDerivedClass(); 

MyBaseClass myBaseObj; 

myBaseObj = myObj; 

myBaseOb] . DoSomething () 7 

结果 如 下 : 

Derived imp 

男 外 ， 还 可 以 使 用 下 面 的 代码 隐藏 基 类 方法 : 


public class MyBaseClass 


public override void DoSomething() => WriteLine ("Derived imp"); 
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public virtual void DoSomething() => WriteLine("Base imp"); 
public class MyDerivedClass : MyBaseClass 


{ 
new public void DoSomething() => WriteLine ("Derived imp"); 
} 


基 类 方法 不 必 是 虚拟 的 ， 但 结果 是 一 样 的 ， 只 需要 修改 上 面 代码 中 的 一 行 即 可 。 对 于 基 类 的 虚拟 方法 和 非 
虚拟 方法 而 言 ， 其 结果 如 下 : 


Base imp 


尽管 隐藏 了 基 类 的 实现 代码 ， 但 仍 可 以 通过 基 类 访问 它 。 
10.2.2 调用 重 写 或 隐藏 的 基 类 方法 


无 论 是 重 写成 员 还 是 隐藏 成 员 ， 都 可 以 在 派生 类 的 内 部 访问 基 类 成 员 。 这 在 许多 情况 下 都 是 很 有 用 的 ， 例 如 : 

e 要 对 派生 类 的 用 户 隐 藏 继承 的 公共 成 员 ， 但 仍 能 在 类 中 访问 其 功能 。 

e 要 给 继承 的 虚拟 成 员 添加 实现 代码 ， 而 不 是 简单 地 用 重 写 的 新 实现 代码 蔡 换 它 。 

为 此 , 可 使 用 base KEF, 它 表示 包含 在 派生 类 中 的 基 类 的 实现 代码 (在 控制 构造 函数 时 , 其 用 法 是 类 似 的 ， 
如 第 9 章 所 述 )， 例 如 ; 

public class MyBaseClass 


{ 
public virtual void DoSomething() 


// Base implementation. 
} 
} 
public class MyDerivedClass : MyBaseClass 
{ 
public override void DoSomething () 
{ 
// Derived class implementation, extends base class implementation. 
base .DoSomething (); 
// More derived class implementation. 
} 
} 
这 段 代 码 在 MyDerivedClass 包含 的 DoSomething0 方 法 中 ,执行 包含 在 MyBaseClass 中 的 DoSomething() 
版 本 ，MyBaseClass 是 MyDerivedClass 的 基 类 。 因 为 base 使 用 的 是 对 象 实 例 ， 所 以 在 静态 成 员 中 使 用 它 会 产生 
错误 。 


this 关键 字 

除了 使 用 第 9 章 的 base 关键 字 外 ， 还 可 以 使 用 this 关键 字 。 与 base 一 样 ，this 也 可 以 用 在 类 成 员 的 内 部 ， 
且 该 关键 字 也 引用 对 象 实例 。 只 是 this 引用 的 是 当前 的 对 象 实例 ( 即 不 能 在 静态 成 员 中 使 用 this 关键 字 ， 因 为 静 
态 成 员 不 是 对 象 实 例 的 一 部 分 )。 

this 关键 字 最 常用 的 功能 是 把 当前 对 象 实例 的 引用 传递 给 一 个 方法 ， 如 下 例 所 示 : 


public void doSomething () 
{ 


MyTargetClass myObj = new MyTargetClass(); 
myObj.DoSomethingWith (this); 
} 


其 中 ,被 实例 化 的 MyTargetClass 实例 (myObj) 有 一 个 DoSomethingWith0 方 法 ， 该 方法 市 有 一 个 参数 ， 其 类 
型 与 包含 上 述 方法 的 类 兼 容 。 这 个 参数 类 型 可 以 是 类 的 类 型 、 由 这 个 类 继承 的 类 类 型 ， 或 者 由 这 个 类 或 
System.Object 实现 的 一 个 接口 。 

this 关键 字 的 男 一 个 肖 见 用 法 是 限定 局 部 类 型 的 成 员 ， 例 如 : 

public class MyClass 

{ 


private int someData; 
public int SomeData => this.someData; 
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} 
许多 开发 人 员 都 喜欢 这 个 语法 ， 它 可 以 用 于 任意 成 员 类 型 ， 因 为 可 以 一 眼看 出 引用 的 是 成 员 ， 而 不 是 局 部 
z a 


10.2.3 (#AREWABEN 


除了 在 名 称 空间 中 定义 类 型 (如 类 ) 之 外 ， 还 可 以 在 其 他 类 中 定义 它们 。 如 果 这 人 么 做 ， 就 可 以 在 定义 中 使 
用 各 种 访问 修饰 符 ， 而 不 仅 是 public 和 internal， 也 可 以 使 用 new 关键 字 来 隐藏 继承 于 基 类 的 类 型 定义 。 例 如 ， 
以 下 代码 定义 了 MyClass, EX f—^4 ENS myNestedClass: 


public class MyClass 


{ 
public class MyNestedClass 
{ 


_ public int NestedClassField; 
i } 
如 果 要 在 MyClass 的 外 部 实例 化 myNestedClass, 就 必须 限定 名 称 ， 例 如 : 
MyClass.MyNestedClass myObj = new MyClass.MyNestedClass(); 
但 是 ， 如 果 髓 套 的 类 声明 为 私有 ， 就 不 能 这 么 做 。 这 个 功能 主要 用 来 定义 对 于 其 包含 类 来 说 是 私有 的 类 ， 
这 样 ， 名 称 空间 中 的 其 他 代码 就 不 能 访问 它 。 使 用 该 功能 的 男 一 个 原因 是 租 套 类 可 以 访问 其 包含 类 的 私有 和 受 
保护 成 员 。 接 下 来 的 示例 演示 了 网 套 类 。 


iW—in ERRER: Ch10Ex02 


(1) 在 C:\BeginningCSharp7\Chapter10 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch10Ex02. 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using static System.Console; 
namespace ChlOÜEx02 
{ 
public class ClassA 
{ 
private int state = -1; 
public int State => state; 
public class ClassB 
{ 
public void SetPrivateState(ClassA target, int newState) 
{ 
target.state = newState; 
} 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
ClassA myObject = new ClassA(); 
WriteLine ($"myObject.State = {myObject.State}"); 
ClassA.ClassB myOtherObject = new ClassA.ClassB(); 
myOtherObject.SetPrivateState(myObject, 999); 
WriteLine($"myObject.State = {myObject.State}"); 
ReadkKey () ; 


] 
} 


(3) 运行 该 应 用 程序 ， 结 果 如 图 10-3 所 示 。 


| 10-3 
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示例 说 明 

Main0 中 的 代码 创建 并 使 用 了 Classa 的 一 个 实例 ， 该 类 包含 一 个 只 读 属 性 State. 25/8 QUEE f iE S 
ClassA.ClassB 的 一 个 实例 。 访 驶 和 登 类 能 够 访问 ClassA.State IJI EEX ClassA.state， 即 使 这 个 字段 是 一 个 私有 
"EE. Dub. PRESSE TIVE SetPrivateState0 可 以 修改 ClassA 的 只 读 属 性 State 的 值 。 

有 必要 再 次 重申 一 下 ， 之 所 以 可 以 这 么 做 ， 是 因为 ClassB 被 定义 为 ClassA HRE. w RHE ClassB 的 定 
义 移 出 ClassA， 那 么 上 面 的 代码 就 会 产生 如 下 编译 错 误 : 


'ChlOEx02.ClassA.state' is inaccessible due to its protection level. 


TESTI V SPA s SE DA RES — UI Be CEA e TE P TRAH. Bæ, KE BUN BOBO DS e DUT] JT ST 
作 其 内 部 状态 就 足够 了 。 


10.3 接口 的 实现 


在 继续 前 ， 先 讨论 一 下 如 何 定义 和 实现 接口 。 第 9 章 介绍 过 接口 的 定义 方式 与 类 相似 ， 使 用 的 代码 如 下 : 
interface IMyInterface 

// Interface members. 

接口 成 员 的 定义 与 类 成 员 的 定义 相似 ， 但 有 以 下 几 个 重要 区 别 : 

不 允许 使 用 访问 修饰 符 (publie、private、Pprotected 或 internanl， 所 有 接口 成 员 都 是 隐 式 公共 的 。 

接口 成 员 不 能 包含 代码 体 。 

接口 不 能 定义 字段 成 员 。 

不 能 用 关键 字 static. virtual. abstract 或 sealed 来 定义 接口 成 员 。 

类 型 定义 成 员 是 茶 止 的 。 

但 要 隐 羧 从 基 接 口中 继承 的 成 员 ， 可 以 用 关键 字 new 来 定义 它们 ， 例 如 : 


interface IMyBaseInterface 


void DoSomething(); 
interface IMyDerivedInterface : IMyBaseInterface 
| new void DoSomething(); 
RU AA BE UK BS AS va BU X RE. 
在 接口 中 定义 的 属性 可 以 定义 访问 块 get 和 set 中 的 哪 一 个 能 用 于 该 属性 (或 将 它们 同时 用 于 该 属性 ), 例如 : 
interface IMyInterface 


{ 
int MyInt { get; set; } 


其 中 int 属性 MyInt 有 get 和 set 访问 器 。 对 于 访问 级 别 有 更 严格 限制 的 属性 来 说 ， 可 以 省 略 它们 中 的 任 一 个 。 


注音 F 


这 个 语法 类 似 于 自动 属性 , 但 自动 属性 是 为 类 (而 不 是 接口 ) 定 义 的 , 且 自 动 属性 必须 包含 get 和 set 访问 器 。 
接口 没有 指定 应 如 何 存 储 属 性 数据 。 接 口 不 能 指定 字段 ， 例 如 用 于 存储 属性 数据 的 字段 。 最 后 ， 接 口 与 
类 一 样 ， 可 以 定义 为 类 的 成 员 ( 但 不 能 定义 为 其 他 接口 的 成 员 ， 因 为 接口 不 能 包含 类 型 定义 )。 
在 类 中 实现 接口 


实现 接口 的 类 必须 包含 该 接口 所 有 成 员 的 实现 代码 ， 且 必须 匹配 指定 的 签名 (包括 匹配 指定 的 get 和 set ER), 
并 且 必 须 是 公共 的 。 例 如 : 
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public interface IMyInterface 
{ 
void DoSomething(); 
void DoSomethingE1se(); 
} 
public class MyClass : IMyInterface 
{ 
public void DoSomething() {} 
public void DoSomethingElse() {} 
} 


可 使 用 关键 字 virtual BY abstract 来 实现 接口 成 员 ， 但 不 能 使 用 static BK const。 还 可 在 基 类 上 实现 接口 成 员 ， 
例如 : 


public interface IMyInterface 
1 

void DoSomething(); 

void DoSomethingElse(); 


public class MyBaseClass 
{ 
public void DoSomething() |! 


public class MyDerivedClass : MyBaseClass, IMyInterface 
{ 

public void DoSomethingElse() {} 
} 


继承 一 个 实现 给 定 接 口 的 基 类 ， 惑 意味 者 派生 类 隐 式 地 文 持 这 个 接口 ， 例 如 : 


public interface IMyInterface 
{ 

void DoSomething(); 

void DoSomethingElse(); 


public class MyBaseClass : IMyInterface 

{ 
public virtual void DoSomething() {} 
public virtual void DoSomethingElse() {} 


public class MyDerivedClass : MyBaseClass 
{ 

public override void DoSomething() {} 
} 


显然 ， 在 基 类 中 把 实现 代码 定义 为 虚拟 非常 有 用 ， 这 样 派生 类 就 可 以 替换 该 实现 代码 ， 而 不 是 隐藏 它们 。 
如 果 要 使 用 new 关键 字 隐 藏 一 个 基 类 成 员 ， 而 不 是 重 写 它 ， 则 方法 IMyInterface DoSomething0 就 总 是 引用 基 类 
版 本 ， 即 使 通过 这 个 接口 来 访问 派生 类 ， 也 是 这 样 。 


1. 显 式 实现 接口 成 员 


也 可 以 由 类 显 式 地 实现 接口 成 员 。 如 果 这 人 么 做 ， 融 只 能 通过 接口 来 访问 该 成 员 ， 不 能 通过 类 来 访问 。 上 一 
节 的 代码 中 使 用 的 隐 式 成 员 可 以 通过 类 和 接口 来 访问 。 

例如 ， 如 果 类 MyClass 隐 式 地 实现 接口 IMylInterface 的 方法 DoSomethingO0， 如 上 所 述 ， 则 下 面 的 代码 束 是 
有 效 的 : 


MyClass myObj = new MyClass(); 
myOb] .DoSomething(); 


下 面 的 代码 也 是 有 效 的 ; 


MyClass myob] = new MyClass(); 
IMyInterface myInt = myObj; 
myint.DoSomething(); 


另外 ， 如 果 MyDerivedClass 显 式 地 实现 DoSomething), BLA BEE HIR BOR. Rn P: 


public class MyClass : IMyInterface 
{ 
void IMyInterface.DoSomething() {} 
public void DoSomethingElse() {} 
} 
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其 中 DoSomething0 是 显 式 实现 的 ， 而 DoSomethingElse0 是 隐 式 实现 的 。 只 有 后 者 可 以 直接 通过 MyClass 
的 对 象 实例 来 访问 。 

2. 其 他 属性 访问 希 

前 面 说 过 ， 如 果实 现 市 属性 的 接口 ， 就 必须 实现 匹配 的 get/set 访问 器 。 这 并 不 是 绝对 正确 的 一 一 如 果 在 定 
义 属性 的 接口 中 只 包含 set 块 ， 就 可 给 类 中 的 属性 添加 get 块 ， 反 之 亦 然 。 但 只 有 隐 式 实现 接口 时 才能 这 么 做 。 
男 外 ， 大 多 数 时 候 ， 都 想 让 所 添加 的 访问 句 的 可 访问 修饰 符 比 接口 中 定义 的 访问 器 的 可 访问 修饰 符 更 严格 。 因 
为 按照 定义 ， 接 口 定义 的 访问 器 是 公共 的 ， 也 就 是 说 ， 只 能 添加 非 公 共 的 访问 器 。 例 如 : 

public interface IMyInterface 

| int MyIntProperty { get; } 

ues class MyBaseClass : IMyInterface 

| public int MyIntProperty { get; protected set; } 

} 

如 果 将 新 添加 的 访问 器 定义 为 公共 的 ， 那 么 能 够 访问 实现 该 接口 的 类 的 代码 也 可 以 访问 该 访问 器 。 但 是 ， 
只 能 访问 接口 的 代 但 束 不 能 访问 该 访问 右 。 


10.4 ”部 分 类 定义 


如 果 所 创建 的 类 包含 一 种 类 型 或 其 他 类 型 的 许多 成 员 时 ， 就 很 容易 引起 混淆 ， 代 码 文 件 也 比较 长 。 这 时 可 
以 采用 前 面 革 市 介绍 的 一 种 方法 ， 即 给 代码 分 组 。 在 代码 中 定义 区 域 ， 束 可 以 折 同 和 展开 各 个 代码 区 ， 使 代码 
更 便于 阅读 。 例 如 ， 有 一 个 类 的 定义 如 下 : 

public class MyClass 

{ 

#region Fields 
private int myInt; 
#endregion 
#region Constructor 
public MyClass() { myInt = 99; } 
#endregion 
#region Properties 
public int MyInt 
1 
get { return myInt; } 
set { myint = value; } 
#endregion 
#region Methods 
public void DoSomething () 
{ 
// Do something.. 


endregion 

} 

EXO MISH] RATA BIN FE. TE. PERROTTA, DES PASE A CURA. E 
HY Tai RR KE TK, EK eR AEE e E10 KREN I6 ABE FI 

男 一 种 方法 是 使 用 部 分 类 定义 (partial class definition)。 简 言 之 ， 就 是 使 用 部 分 类 定义 ， 把 类 的 定义 放 在 多 个 
文件 中 。 例 如 ， 可 将 字段 、 属 性 和 构造 函数 放 在 一 个 文件 中 ， 而 把 方法 放 在 男 一 个 文件 中 。 为 此 ， 在 包含 部 分 
类 定义 的 每 个 文件 中 对 类 使 用 partial 关键 字 即 可 ， 如 下 所 示 : 

public partial class MyClass { ...} 

如 末 使 用 部 分 类 定义 ，partial RE 394520 LE BL RRIK EEA SCTETE SC Id Ba E 

例如 ， 类 MainWindow 中 的 WPF 窗口 将 代码 存储 在 两 个 文件 MainWindow.xaml.cs 和 MainWindow.g.i.cs 中 
(在 Solution Explorer 中 选择 Show All Files 并 打开 obj\Debug 文件 夹 就 可 以 看 到 它们 )。 这 样 就 可 以 重点 考虑 窗 体 
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的 功能 ， 不 必 担 心 代码 会 被 目 己 不 感 兴趣 的 信息 搅乱 。 
对 于 部 分 类 ， 最 后 要 注音 的 一 点 是 : 应 用 于 部 分 类 的 接口 也 会 应 用 于 整个 类 ， 也 就 是 说 ， 下 面 的 两 个 定义 : 


public partial class MyClass : IMyInterfacel { ... } 
public partial class MyClass : IMyInterface2 { ... } 


和 

public class MyClass : IMyInterfacel, IMyInterface2 { ... } 

是 等 价 的 。 

部 分 类 定义 可 以 在 一 个 部 分 类 定义 文件 或 者 多 个 部 分 类 定义 文件 中 包含 基 类 。 但 如 果 基 类 在 多 个 定义 文件 
中 指定 ， 它 就 必须 是 同一 个 基 类 ， 因 为 在 C# 中 ， 类 只 能 继承 一 个 基 类 。 


10.5 ”部 分 方法 定义 


部 分 类 也 可 以 定义 部 分 方法 (partial method)。 部 分 方法 在 一 个 部 分 关中 定义 (没有 方法 体 )， 在 尺 一 个 部 分 类 
中 实现 。 在 这 两 个 部 分 类 中 ， 都 要 使 用 partial 关键 字 。 


public partial class MyClass 

| partial void MyPartialMethod() ; 

ES partial class MyClass 

i partial void MyPartialMethod() 

' // Method implementation 

l } 

部 分 方法 也 可 以 是 静态 的 ， 但 它们 总 是 私有 的 ， 且 不 能 有 返回 值 。 它 们 使 用 的 任何 参数 都 不 能 是 out 参数 ， 
但 可 以 是 ref 参数。 部 分 方法 也 不 能 使 用 virtual. abstract. override. new. sealed 或 extern 修饰 付 。 

有 了 这 些 限制 ， 就 不 太 容 易 看 出 部 分 方法 的 作用 了 。 实 际 上 ， 部 分 方法 的 重要 性 体现 在 编译 代码 时 ， 而 不 
是 使 用 代码 时 。 考 虑 下 面 的 代码 : 


public partial class MyClass 
{ 
partial void DoSomethingE1se(); 
public void DoSomething () 
{ 
WriteLine("DoSomething() execution started."); 
DoSomethingElse () ; 
WriteLine("DoSomething() execution finished."); 
} 
} 
public partial class MyClass 
{ 


partial void DoSomethingElse() => 
WriteLine("DoSomethingElse() called."); 
} 


在 第 一 个 部 分 类 定义 中 定义 和 调用 部 分 方法 DoSomethingElse0， 在 第 二 个 部 分 类 中 实现 它 。 在 控制 台 应 用 
程序 中 调用 DoSomething0 方 法 时 ， 输 出 如 下 内 容 : 


DoSomething() execution started. 
DoSomethingElse() called. 
DoSomething() execution finished. 


如 果 删 除 第 二 个 部 分 类 定义 ， 或 者 删除 部 分 方法 的 全 部 实现 代码 (或 者 注释 掉 这 部 分 代码 )， 输 出 就 如 下 
所 示 : 


DoSomething() execution started. 
DoSomething() execution finished. 


读者 可 能 认为 ， 调 用 DoSomethingElse0O 时 ， 运行 库 友 现 该 方法 没有 实现 代码 ， 因 此 会 继续 执行 下 一 行 代码 。 
但 实际 上 ， 编 译 代 码 时 ， 如 果 代 人 码 包含 一 个 没有 实现 代码 的 部 分 方法 ， 编 详 器 会 完全 删除 该 方法 ， 还 会 删除 对 
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该 方法 的 所 有 调用 。 执 行 代码 时 ， 不 会 检查 实现 代码 ， 因 为 没有 要 检查 的 方法 调用 。 这 会 略微 提高 性 能 。 

与 部 分 类 一 样 ， 在 定制 自动 生成 的 代码 或 设计 器 创建 的 代码 时 ， 部 分 方法 是 很 有 用 的 。 设 计 器 会 声明 部 分 
方法 ， 用 户 根据 具体 情形 选择 是 否 实现 它 。 如 果 不 实 现 它 ， 就 不 会 影响 性 能 ， 因 为 在 编译 过 的 代码 中 并 不 存在 
该 方法 。 

现在 考虑 为 什么 部 分 方法 不 能 有 返回 类 型 。 如 果 可 以 回答 这 个 问题 ， 就 可 以 确保 完全 理解 了 这 个 主题 ， 我 
们 将 此 留 作 练习 。 


10.6 示例 应 用 程序 


为 解释 前 面 使 用 的 一 些 技术 ， 下 面 开 发 一 个 类 模块 ， 以 便 在 后 续 章 市 中 使 用 。 这 个 类 模块 包含 两 个 类 : 
e Card — 表示 一 张 标 准 的 扑克 牌 ， 包含 梅 化 、 方 块 、 红 心 和 黑 桃 ， 其 顺序 是 从 A 到。 
e Deck — 表示 一 副 完整 的 52 张 扑克 牧 ， 在 扑克 牌 中 可 以 按照 位 置 访问 各 张 牧 并 可 以 洗 有 牌 。 
再 开 友 一 个 简单 的 客户 程序 ， 确 保 这 个 模块 能 正 第 使 用 ， 但 现在 还 不 开发 完整 的 扑克 牌 游 戏 应 用 程 订 。 


10.6.1 规划 应 用 程序 


这 个 应 用 程序 的 类 库 Ch10CardLib 包含 一 些 类 。 但 在 开始 编写 代码 前 , 应 规划 一 下 需要 的 结构 和 类 的 功能 。 
1. Card 类 


Card 类 基本 上 是 两 个 只 读 字 段 suit 和 rank 的 容器 。 把 字段 指定 为 只 读 的 原因 是 “ 衬 日 ”的 牌 是 没有 意义 的 ， 
牌 在 创建 好 后 也 不 能 修改 。 为 此 ， 要 把 默认 的 构造 冰 数 指定 为 私有 ， 并 提供 另 一 个 构造 函数 ， 使 用 给 定 的 suit 和 
rank 建立 一 张 扑克 牌 。 

此 外 ，Card 类 要 重 写 System.Object 的 ToString0 方 法 ， 这 样 才能 获得 人 们 可 以 理解 的 字符 串 ， 以 表示 扑克 
有 牌 。 为 使 编码 便 单 一些， 为 两 个 字段 suit Al rank 提供 枚 举 。 

Card 类 如 图 10-4 所 示 。 


2. Deck 类 


Deck 类 包含 52 个 Card 对 象 。 我 们 为 这 些 对 象 使 用 一 个 简单 的 数组 类 型 。 这 个 数组 不 能 直接 访问 ， 因 为 对 
Card 对 象 的 访问 要 通过 GetCard0 方 法 来 实现 ， 该 方法 返回 指定 索引 的 Card 对 象 。 这 个 类 也 应 有 一 个 Shuffle() 
方法 ， 用 于 日 新 排列 数组 中 的 牌 。Deck 类 如 图 10-5 所 示 。 


cd 


+suit 
+rank 


+ToString() 


Deak 
-cards : Card] 


4 | *GetCard() 
+Desk() 
TShuffle() 


| Cad — 


Tsult 
«rank 


+ToString() 


10-5 


106.2 编写 类 库 


对 于 本 例假 定 读者 对 IDE 比较 熟悉 ， 所 以 不 再 使 用 标准 的 “ 试 一 试 ”方式 明确 列 出 各 个 步骤 (这 些 步骤 已 
经 在 前 面 多 次 用 过 )， 重 要 的 是 详细 讨论 代码 。 不 过 ， 这 里 要 包含 一 些 提示 以 确保 不 出 问题 
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类 和 枚 举 部 包含 在 一 个 类 库 项 目 Ch10CardLib 中 。 这 个 项 目 将 包含 4 个 .cs 文件 ， Card.es 包含 Card ANE 
X, Deck.cs 包含 Deck 类 的 定义 ，Suit.cs 和 Rank.es 文件 包含 枚 举 。 
可 使 用 Visual Studio 的 类 图 工具 把 许多 代码 组 合 在 一 起 。 


注意 : 

如 果 不 愿 意 使 用 类 图 工具 ， 也 不 必 担 心 。 下 面 各 节 都 包含 了 类 图 生成 的 代码 ， 所 以 读者 完全 可 以 理解 这 些 
Ae. 

首先 需要 完成 以 下 操作 : 

(1) 在 C:\BeginningCSharp7\Chapter10 目录 中 创建 一 个 新 类 库 项 目 Ch10CardLib。 

(2) 从 项 目 中 删除 Classl.cs。 

(3) 在 Solution Explorer 窗口 中 打开 项 目的 类 图 ( 右 击 项 目 ， 然 后 单 击 View | View Class Diagram). X ET 48 
时 应 为 空 日 ， 因 为 项 目 不 包 含 类 。 这 样 束 在 项 目 中 创建 了 一 个 ClassDiagraml.ed 文件 ， 以 备 后 用 。 


1. 添加 Suit 和 Rank 枚 举 
在 打开 的 ClassDiagraml.ed 文件 中 ， 把 一 个 Enum 从 工具 箱 拖 动 到 类 图 中 ， 由 在 显示 的 New Enum 对 话 框 
中 填写 信息 ， 束 可 以 在 类 图 中 添加 一 个 枚 举 。 例 如 ， 对 于 Suit 枚 举 ， 应 在 对 话 框 中 添加 如 图 10-6 所 示 的 信息 。 


Enum name: 
Suit 


Access: 


public 
File name: 
@ Create new file 


Suit.cs 


Q Add to existing file 


10-6 


接着 使 用 Class Details 窗口 添加 榴 举 的 成 员 ( 在 ClassDiagraml.ed 文件 中 ， 右 击 刚 添加 的 Suit， 选 择 Enum | 
Class Details)。 需 要 添加 的 值 如 图 10-7 所 示 。 


Summary 


Diamond 
Heart 


Spade 


zada member> 


以 相同 的 方式 利用 工具 箱 添加 Rank 枚 举 。 需 要 的 值 如 图 10-8 所 示 。 
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Output Class Details 


图 10-8 


tm: 


第 一 个 成 员 Ace 的 值 设置 为 1， 它 会 使 枚 举 的 底层 存储 匹配 扑克 牌 的 大 小 ， 例 如 Six 就 存储 为 6. 


为 这 两 个 枚 举 生成 的 代码 位 于 Suit.cs 和 Rank.cs 文件 中 。 在 Ch10CardLib 文件 夹 的 Suit.cs 文件 中 可 以 找到 
Suit 枚 举 的 完整 代码 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

namespace ChlOCardLib 


{ 
public enum Suit 
{ 
Club, 
Diamond, 
Heart, 
Spade, 
} 
} 


在 ChlOCardLib 文件 夹 的 Rank.es 文件 中 可 以 找到 Rank 枚 举 的 完整 代码 ， 如 下 所 示 : 


using System; 
using System.Collections.Generic; 
using System.Ling; 
using System.Text; 
namespace ChlOCardLib 
{ 
public enum Rank 
{ 
Ace = 1, 
Deuce, 
Three, 
Four, 
Five, 
Six, 
Seven, 
Eight, 
Nine, 
Ten, 
Jack, 
Queen, 
King, 
} 
} 


男 外 ， 也 可 添加 Suit.es 和 Rank.cs (RSX F, FR i AEE. HER, TUBAE uds fESUHR — | BOE I 
TURES MNES Asia PE, Aas BE 2 a, fH'TIRIBER T 2 LEAL 


2. xt Card 类 

本 节 将 结合 使 用 类 设计 器 和 代码 编辑 器 来 添加 Card 类 。 使 用 类 设计 器 添加 类 与 添加 枚 举 十 分 类 似 , 也 是 把 
相应 的 项 从 工具 箱 拖 动 到 类 图 中 。 这 里 要 把 Class 拖 动 到 类 图 中 ， 并 把 新 类 命名 为 Card. 

使 用 Class Details 窗口 添加 字段 rank 和 suit, 再 使 用 Properties 窗口 把 字段 的 Constant Kind 设置 为 readonly。 
还 需要 添加 两 个 构造 函数 ,一 个 是 默认 构造 函数 (私有 ), 男 一 个 构造 函数 (公共 ) 市 有 两 个 参数 : newSuit 和 newRank, 
其 类 型 分 别 是 Suit 和 Rank。 最 后 重 写 ToStming0， 这 需要 在 Properties 窗口 中 修改 Inheritance Modifier， 将 它 设 置 
为 override。 

图 10-9 显示 了 Class Details 窗口 和 已 输入 所 有 信息 的 Card 类 (可 在 Ch10CardLib\Card.cs 中 找到 其 代码 )。 


Modifier - Summary — — — —— T li J 


private 


() «add parameter» 
4 ? Card public 
【 newSuit Sui None 
. hewRank n None 
) <add parameter» 
4 € ToString stri public 
() «add parameter» 
© «add method» 
4 Properties 
# <add property» 
4 Fields 
€ rank an public 
€ suit Sui public 
€ <add field» 
4 Events 


* «add event» 


Output Class Details 
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然后 需要 修改 Card.es 中 类 的 代码 (或 将 这 些 代码 添加 到 名 称 空间 Ch10CardLib 的 新 类 Card 中 )， 如 下 所 示 : 


public class Card 
{ 
public readonly Suit suit; 
public readonly Rank rank; 
public Card(Suit newSuit, Rank newRank) 
i 
suit = newSuit; 
rank = newRank; 
} 
private Card() {} 
public override string ToString() => "The " + rank + " of " + suit + "s"; 
} 
重 写 的 ToStrng0 方 法 将 已 存储 的 枚 举 值 的 字符 串 表 示 写 入 到 返回 的 字符 串 中 ， 非 默认 的 构造 图 数 初 始 化 


suit 和 rank 字段 的 值 。 
3. XJ Deck 类 
Deck 类 需要 使 用 类 图 定义 以 下 成 员 : 
Card[] 类 型 的 私有 字段 cards。 
公共 的 默认 构造 函数 。 
公共 方法 GetCard0， 它 市 有 一 个 int 参数 cardNum， 并 返回 一 个 Card 类 型 的 对 象 。 
公共 方法 Shuffle), CATER, VE] void. 
添加 这 些 成 员 后 rn» Deck 类 的 Class Details 窗口 就 如 图 10-10 所 示 。 
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为 使 关 图 更 加 清晰 ， 可 以 显示 所 添加 的 成 员 和 类 型 之 间 的 关系 。 在 类 图 中 依次 右 击 下 面 的 项 ， 从 沫 单 中 选 


f£ Show as Association 选项 : 


e Deck 中 的 cards 
e Card 中 的 suit 
e Card 中 的 Tank 


完成 后 的 类 图 如 图 10-11 所 示 。 


ClassDiagrami.cd P X 


Card 
Class 


Deck 
Class 
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& Deck 
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接着 修改 Deck.cs 中 的 代码 (如 果 不 使 用 类 设计 器 ， 
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就 必须 首先 使 用 下 面 的 代码 添加 这 个 类 )。 这 些 代码 包含 


在 Ch10CardLib\Deck.cs 中 。 首 先 实现 构造 函数 ， 它 在 cards 字段 中 创建 52 张 牌 ， 并 给 它们 赋值 。 对 两 个 枚 举 
的 所 有 组 合 进行 迭代 ， 每 次 迭代 都 创建 一 张 牌 。 这 将 使 cards 最 初 包含 一 个 有 序 的 扑克 牌 列表 : 


using 
using 
using 


system; 
System.Collections.Generic; 
System. Ling; 

using System.Text; 

using System. Threading. Tasks; 
namespace ChlOCardLib 

{ 
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public class Deck 
{ 


private Card[] cards; 
public Deck () 
{ 
cards = new Card[52]; 
for (int suitVal = 0; suitVal < 4; suitVal++) 


{ 
for (int rankVal = 1; rankVal < 14; rankVal++) 
{ 
cards[suitVal * 13 + rankVal -1] = new Card((Suit)suitVal, 
(Rank) rankVal) ; 
} 
} 
FH 


然后 实现 GetCard0 方 法 ， 为 指定 的 索引 返回 Card 对 象 ， 或 者 以 与 前 面相 同 的 方式 抛 出 一 个 异常 
public Card GetCard(int cardNum) 
{ 


if (cardNum >= 0 && cardNum <= 51) 
return cards[cardNum]; 
else 
throw 
(new System.ArgumentOutOfRangeException("cardNum", cardNum, 
"Value must be between 0 and 51.")); 
} 


最 后 实现 Shuffle0 方 法 。 36 27 12 8] E — ^| Ws Th ch, FE Th AA ES] cards 数组 随机 复制 到 
XX 24H P KS E BU EE — TS 0-51 的 循环 , 在 每 次 循环 时 , 都 会 使 用 NET Framework 中 System.Random 
类 的 实例 生成 一 个 0-51 之 间 的 随机 数 。 进 行 实例 化 后 ， 这 个 类 的 对 象 使 用 方法 NextCO 生 成 一 个 介 于 0~ 义 之 
间 的 随机 数 。 有 了 一 个 随机 数 后 ， 束 可 以 将 它 用 作 临 时 数组 中 Card 对 象 的 索引 ， 以 便 复制 cards 数组 中 的 扑 
pL E 

Ack GB Th che, SEA — 7 bool 变量 的 数组 ， 在 复制 每 张 牌 时 ， 把 该 数组 中 的 值 指定 为 true。 
在 生成 随机 数 时 ， 检 查 这 个 数组 ， 看 看 是 否 已 经 把 一 张 牌 复制 到 临时 数组 中 由 随机 数 指定 的 位 置 上 了 ， 如 果 已 
经 复制 ， 将 生成 男 一 个 随机 数 。 

这 不 是 完成 该 任务 的 最 高 效 方式 ， 因 为 生成 的 许多 随机 数 都 可 能 找 不 到 空位 置 以 复制 扑 死 牌 。 但 它 仍 
能 完成 任务 ， 而 且 很 简单 ， 因 为 C# 代 码 的 执行 速度 很 快 ， 我 们 几乎 沉 穴 不 到 延迟 。 人 代码 如 下 : 

public void Shuffle() 


Card[] newDeck = new Card[52]; 
bool[] assigned = new bool[52]; 
Random sourceGen = new Random(); 
for (int i = 0; i < 52; i++) 
{ 
int destCard = 0; 
bool foundCard = false; 
while (foundCard == false) 
{ 
destCard = sourceGen.Next (52); 
if (assigned[destCard] == false) 
foundCard = true; 
} 
assigned[destCard] = true; 
newDeck[destCard] = cards[il: 
} 
newDeck.CopyTo(cards, 0); 
} 
} 
} 


这 个 方法 的 最 后 一 行使 用 System. Array 类 的 CopyTo0 方 法 (在 创建 数组 时 使 用 )， 把 newDeck 中 的 每 张 扑克 
牌 复制 回 cards 中 。 也 就 是 说 ， 我 们 使 用 同一 个 cards 对 象 中 的 同一 组 Card 对 象 ， 而 不 是 创建 新 实例 。 如 果 改 
用 cards=newDeck， 就 会 用 另 一 个 对 象 替代 cards 引用 的 对 象 实例 。 如 果 其 他 地 方 的 代码 仍 保留 对 原 cards 实例 
的 引用 ， 就 会 出 问题 一 -不 会 洗 牌 。 

至 此 ， 就 完成 了 类 库 代 码 。 


178 | 第 1 部 分 C# 语言 


1063 ”类 库 的 客户 应 用 程序 


为 简单 起 见 ， 可 以 在 包含 类 库 的 解决 方案 中 添加 一 个 客户 控制 台 应 用 程 订 。 为 此 ， 只 需要 在 Solution Explorer 
窗口 中 右 击 解决 方案 ， 选 择 Add | New Project， 将 新 项 目 命名 为 Ch10CardClient。 

为 在 这 个 新 的 控制 台 应 用 程序 项 目 中 使 用 前 和 面 创建 的 类 库 ， 只 需要 添加 一 个 对 类 库 项 目 Ch10CardLib 的 引 
FA. Ak, n] WA Reference Manager 对 话 框 的 Projects 选项 卡 ( 右 击 Ch10CardClient 项 目 ,然后 选择 Add | Reference 
| Projects)， 如 图 10-12 所 示 。 


b Assemblies Search Projects (Ctri+E) P~ 


4 Projects Name Path = Name: 


: BeginningCSharp? CABeginningCSharp7ABeginningCSharp7BeginningCSharp7.csproj Chi0CardLib 
SOT ChO6Ex01 CABeginningCSharp7\Chapter06\ChO6Ex01\ChOGEx01 csproj 
Va ChO6Ex02 C\BeginningCSharp7\Chapter06\Ch06Ex02\ChOGEN02.csproj 
ChÜGEx03 CABeginningCSharp "Chapterü6ChOGEx03V C hOGEx03.cspraj 
b COM ChÜ6Ex04 CABeginningCSharp/ MC hapterüGChÜ6ExO4ChÜGEx0A.csproj 
ChO6Ex05 C\BeginningC Sharp hapterD6XChÜO6ExO05XChÜ6Ex05.csproj 
b Browse ChÜTExO1 CABeginningCSharp7VChapterü Ch 7 ExXOTVChO 7 Ex01.csproj 
ChO7Ex01TracePoints CA\BeginningCSharp/\Chapter07\Ch07Ex01 TracePoints\ChO7Ex0 1 TracePo... 
ChO9ClassLib CABeginning Sharp /\\Chapter09,ChO9ClassLib\ChOOC lassLib.csproj 
ChOSEx01 CABeginningCSharp?\Chapter09\ChO9Ex01\ChO9Ex01 .csproj 
ChO9ExO2 CA Beginning Sharp/\\Chapter09\ChO9Ex02\ChO9ENO2.csproy 
... ChO9Ex03 C:\BeginningCSharp7\Chapter09\Ch09Ex03\ChO9Ex03.csproj 
Chi0CardLib C\BeginningCSharp?\Chapter10,Ch10CardLib\Ch10CardLib. 
CABeginning CSharp Chapter 10\Ch 10Ex01\Ch10Ex01.csproj 
C\BeginningCSharp?\Chapter10\Ch 10Ex02\Ch10Ex02. csproj 
CABeginningCSharp?\Chaptert 1\0h11Ex01\Ch1 1Ex01 .csproj 
CABeginningCSharp "Chapter12*Ch12Ex0TVCh12Ex01.csproj 
CABeginningCSharp A/Chapter12*Ch12Ex02XCh12Ex02.csproj 
CABeginningC5harp Chapter 12XCh12Ex03XCh12Ex03.csproj 
CABeninninat Shami Chanter TWh Feld Ch 12 Pell eanrani 


E] 10-12 


选择 项 目 ， 单 击 OK 按钮 ， 就 添加 了 引用 。 

因为 这 个 新 项 目 是 创建 的 第 二 个 项 目 ， 所 以 还 需要 指定 该 项 目 是 解决 方案 的 后 动 项 目 ， 即 在 单 击 Run 后 ， 
将 执行 这 个 项 目 。 为 此 ， 在 Solution Explorer 窗口 中 右 击 该 项 目 名 ， 选 择 Set as StartUp Project 六 单项 。 

然后 需要 添加 使 用 新 类 的 代码 ,这些 代码 不 需要 做 什么 特别 的 任务 ， 所 以 添加 下 面 的 代码 融 可 以 (这 些 代 
BEA (E 3 x fF Ch10CardClient\Program.cs 中 ): 


using System; 
using System.Collections.Generic; 
using System.Linq; 
using System.Text; 
using System.Threading.Tasks; 
using static System.Console; 
using ChlOCardLib; 
namespace ChlOCardClient 
{ 

class Program 


{ 


static void Main(string[] args) 
{ 
Deck myDeck = new Deck(); 
myDeck .Shuffle() ; 
for (int i = 0; i « 52; i++) 
{ 
Card tempCard = myDeck.GetCard(i) ; 
Write (tempCard.ToString()) ; 
if (i !- 51) 
Write(", "); 
else 
WriteLine(); 
) 
ReadkKey () ; 


一 一 


运行 该 应 用 程序 ， 结 果 如 图 10-13 所 示 。 
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10-13 


52 张 扑 殉 牌 是 随机 放置 的 。 后 续 划 市 将 继续 开发 和 使 用 这 个 类 库 。 


10.7 Call Hierarchy 窗口 


现在 分 析 Visual Studio 的 男 一 项 功能 ;Call Hierarchy 窗口 ， 在 该 窗口 中 可 以 审查 代码 ， 确 定 方法 在 哪里 调 
用 ， 以 及 它们 与 其 他 方法 的 关系 。 说 明 这 个 功能 的 最 好 方式 是 列举 一 个 例子 。 

打开 上 一 节 的 示例 应 用 程序 ,再 打开 Deck.es 代码 文件 ,找到 Shuffe0 方 法 , 右 击 它 , 选 择 View Call Hierarchy 
菜单 项 ， 将 显示 如 图 10-14 所 示 的 窗口 (其 中 展开 了 一 些 区 域 )。 


Call Hierarchy 


My Solution - Q 


4 & Shuffle) (Ch) 0CardLib.Deck) Call Sites faces i 
à 是 Calls To ‘Shuffle’ 
E ©, Main(string[D (ChlüCardClient.Program) 
4 im] Calls To 'Main' 
©) Search found no results 
4 im] Calls From ‘Main’ 
b © DeckQ (ChlüCardLib.Deck) 

b © GetCard(ünt) (ChlüCardLib.Deck) 
bg ReadKey() (Syster. Console) 
t © Shuffle (ChlüCardLib.Deck) 
bg lostng( iChlüCardLib. Card) 
bo 
[ 


destCard = sourceGen.Next(52): Deck.cs - (45, 37) 


Write(string) (System.Console) 
>» © WriteLine( (System. Consola) 
4 im) Calls From 'Shuffle' 
b @ CopyTo(System.Array, int) (Array) 
d) Mextünt) (System.Random) 
b @ Random (System.Randorm) 


Output Breakpoints Call Hierarchy 


10-14 


从 Shuffle0 方 法 开始 ， 可 在 窗口 的 树 形 视图 中 找 出 调用 该 方法 的 所 有 代码 ， 以 及 这 个 方法 进行 的 所 有 调用 。 
例如 ， 在 Shuffle0 中 调用 了 图 中 突出 显示 的 NextQnt) 方 法 ， 所 以 它 显 示 在 Calls From ‘Shuffle’ 部 分 。 单 击 一 个 调 
用 时 ， 会 在 右边 看 到 进行 这 个 调用 的 代码 行 及 其 位 置 。 双 击 该 位 置 ， 会 立即 跳 到 进行 这 个 调用 的 代码 行 上 。 

调试 和 重 构 代码 时 ， 这 个 窗口 是 非常 有 用 的 ， 因 为 它 允许 查看 不 同 部 分 的 代码 是 如 何 相关 的 。 


10.8 ”习题 


(1) 编写 代码 ， 定 义 一 个 基 类 MyClass， 其 中 包含 虚拟 方法 GetString0。 这 个 方法 应 返回 存储 在 受 保护 字段 
myString 中 的 字符 串 ， 该 字段 可 以 通过 只 写 公共 属性 ContainedString 来 访问 。 

(2) M28 MyClass 中 派生 一 个 类 MyDerivedClass. 重 写 GetString0 方 法 , 使 用 该 方法 的 基 类 实现 代码 从 基 关 
中 返回 一 个 字符 串 ， 但 在 返回 的 字符 串 中 添加 文本 “(output from derived class)”. 
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(3) 部 分 方法 定义 必须 使 用 void 返回 类 型 。 说 明 其 原因 。 

(4) 编写 类 MyCopyableClass， 该 类 可 以 使 用 方法 GetCopyO 返 回 它 本 身 的 一 个 副本 。 这 个 方法 应 使 用 派生 
F System.Object 的 MemberwiseClone0 方 法 。 为 该 类 添加 一 个 简单 属性 ， 并 且 编 写 客 户 代 人 码 ， 客 户 代 码 使 用 该 
类 检查 任务 是 人 否 成功 执 行 。 

(5) 为 Ch10CardLib 库 编写 一 个 控制 台 客 己 程 序 ， 从 洗 牌 后 的 Deck 对 象 中 一 次 取出 5 张 牧 。 如 果 这 5 SHH 
部 是 相同 的 人 花色， 客户 程序 就 应 在 屏 医 上 显示 这 5 UK, LAR CAS “Flush!”, AUEREA 50 张 碑 以 后 就 输出 
MAS “No flush”, HRE. 

附录 A 给 出 了 习题 葡 案 。 


109 ABBA 


to d 要 M 
可 在 类 中 定义 字段 、 方 法 和 属性 成 员 。 字 段 用 可 访问 性 、 名 称 和 类 型 定义 ， 方 法 用 可 访问 性 、 返 回 类 型 、 
成 员 定 义 名 称 和 参数 定义 ， 属 性 用 可 访问 性 、 名 称 、get 和 /或 set 访问 器 定义 。 各 个 属性 访问 器 可 以 有 自己 的 可 访问 


性 ， 但 它 必 须 低 于 整个 属性 的 可 访问 性 

属性 和 方法 可 在 基 类 中 定义 为 抽象 或 虚拟 ， 以 定义 继承 。 派 生 类 必须 实现 抽象 的 成 员 ， 使 用 override 关键 
成 员 隐 藏 和 重 写 | 字 可 以 重 写 虚 拟 的 成 员 。 派 生 类 还 可 以 用 new 关键 字 提供 新 的 实现 代码 ， 用 sealed 关键 字 禁 止 进一步 重 写 
虚拟 成 员 。 可 用 base 关键 字 调用 基 类 的 实现 代码 
实现 了 接口 的 类 必须 实现 该 接口 定义 为 “公共 ”的 所 有 成 员 。 可 以 隐 式 或 显 式 实现 接口 ， 其 中 显 式 实现 代 


接口 的 实现 
码 只 能 通过 接口 引用 来 使 用 
使 用 partial 关键 字 可 以 把 类 定义 放 在 多 个 代码 文件 中 。 还 可 以 使 用 partial 关键 字 创 建部 分 方法 。 部 分 方法 有 


一 些 限 制 ， 包 括 没 有 返回 值 或 out 参数 ， 如 果 没 有 提供 实现 代码 ， 就 不 能 编译 部 分 方法 


1] 


集合 、 比 较 和 转换 


REBAR: 

如 何 定 义 和 使 用 集合 

可 以 使 用 的 不 同类 型 的 集合 

如 何 比 较 类 型 ， 如 何 使 用 is 运算 符 
如 何 比较 值 ， 如 何 重 载运 算得 
如 何 定 义 和 使 用 转换 

如 何 使 用 as 运算 符 


本 章 源 代 码 可 以 通过 本 书 合 作 站 点 Wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapterll 文件 夹 中 并 已 根据 本 草 示 例 的 
名 称 单独 命名 。 


前 和 面 讨论 了 了 C# 中 所 有 的 基本 OOP RA, (AAEM ERECTO RIZR SOR. FERS TIS, ei 
要 使 用 这 些 技术 解决 条 些 问题 。 学 习 这 些 技术 可 以 让 开发 过 程 更 加 顺畅 ， 让 你 把 注意 力 集中 到 应 用 程序 其 他 
更 重要 的 方面 。 本 章 主 要 内容 如 下 : 

e RA: 可 以 使 用 集合 来 维护 对 象 组 .与 前 面 划 节 使 用 的 数组 不 同 ， 集 合 可 以 包含 更 高 级 的 功能 ， 例 如 ， 

控制 对 它们 包含 的 对 象 的 访问 、 搜 索 和 排序 和 等。 本章 将 介绍 如 何 使 用 和 创建 集合 类 ， 和 学习 充分 利用 它 
们 的 一 些 强 大 技术 。 

e 比较 : 在 处 理 对 象 时 ， 第 要 比较 它们 。 这 对 于 集合 尤其 重要 ， 因 为 这 是 排序 的 实现 方式 。 本 章 将 介绍 如 

何以 各 种 方式 比较 对 象 (包括 运算 人 符 重 载 )， 如 何 使 用 Comparable 和 IComparer 接口 对 集合 进行 排序 。 

e 转换 : 表面 的 划 节 介绍 了 如 何 把 对 象 从 一 种 类 型 转换 为 刃 一 种 关 型 。 本 章 讨论 如 何 定制 类 型 转换 ， 以 满 

EH Om. 


11.1 集合 


第 5 章 介 绍 了 如 何 使 用 数组 创建 包含 许多 对 象 或 值 的 变量 类 型 。 但 数组 有 一 定 的 限制 。 RANER 
Ta 


创建 好 数组 ， 它 们 的 大 小 就 是 固定 的 ， 不 能 在 现 有 数组 的 末尾 添加 新 项 ， 除 非 创 建 一 个 新 数组 。 这 第 " 
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用 于 处 理 数组 的 语法 比较 复杂 。OOP 技术 可 以 创建 在 内 部 执行 大 多 数 此 类 处 理 的 类 ， 因 此 简化 了 使 用 项 列表 或 
数组 的 代码 。 

C# 中 的 数组 实现 为 System.Array 类 的 实例 ,它们 只 是 集合 类 (Collection Class) 中 的 一 种 类 型 。 集 合 类 一 般 用 
于 处 理 对 象 列表 , 其 功能 比 简 单数 组 要 多 , 功能 大 多 是 通过 实现 System.Collections 名 称 空间 中 的 接口 而 获得 的 ， 
因此 集合 的 语法 已 经 标准 化 了 。 这 个 名 称 空间 还 包含 其 他 一 些 有 趣 的 东西 ， 例 如 ， 以 不 同 于 System.Array 的 方 
式 实现 这 些 接口 的 类 。 

集合 的 功能 (包括 基本 功能 ， 例 如 ， 用 [index] 语 法 访问 集合 中 的 项 ) 可 以 通过 接口 来 实现 ， 所 以 不 仅 可 以 使 
用 基本 集合 类 ， 例 如 System.Armray， 还 可 以 创建 目 己 的 定制 集合 类 。 这 些 集合 可 以 专用 于 要 枚 举 的 对 象 ( 即 要 从 
中 建立 集 合 的 对 象 )。 这 么 做 的 一 个 优点 是 定制 的 集合 类 可 以 是 强 类 型 化 的 。 也 就 是 说 ， 从 集合 中 提取 项 时 ， 不 
需要 把 它们 转换 为 正确 类 型 。 男 一 个 优点 是 提供 专用 的 方法 ， 例 如 ， 可 以 提供 获得 项 子 集 的 快捷 方法 。 在 扑克 
牌 示例 中 ， 可 以 添加 一 个 方法 ， 来 获得 特定 人 花色 中 的 所 有 Card 项 。 

System.Collections 名 称 空间 中 的 以 下 几 个 接口 提供 了 基本 的 集合 功能 : 

e IEnumerable 一 一 可 以 进 代 集 合 中 的 项 。 

e ICollection 一 一 继承 于 IEnumerable. 可 以 获取 集合 中 项 的 个 数 , 并 能 把 项 复制 到 一 个 简单 的 数组 类 型 中 。 

e IList 一 一 继承 于 IEnumerable 和 ICollection。 提 供 了 集合 的 项 列表 ， 人 允许 访问 这 些 项 ， 并 提供 其 他 一 些 

与 项 列表 相关 的 基本 功能 。 
e IDictionary 一 一 继承 于 IEnumerable 和 ICollection。 类 似 于 IList， 但 提供 了 可 通过 键 值 (而 不 是 索引 ) 访 问 
的 项 列表 。 

System. Array 类 实现 了 List、ICollection 和 IEnumerable， 但 不 支持 IList 的 一 些 更 局 级 功能 ， 它 表示 大 小 固 

定 的 项 列表 。 


11.1.1 使 用 集合 

Systems.Collections 名 称 空间 中 的 类 System.Collections.ArrayList 也 实现 了 IList, ICollection 和 IEnumerable 
接口 ， 但 实现 方式 比 System Array 更 复杂 。 数 组 的 大 小 是 固定 不 变 的 (不 能 添加 或 删除 元 素 )， 而 这 个 类 可 以 用 
于 表示 大 小 可 变 的 项 列表 。 为 了 更 准确 地 理解 这 个 高 级 集合 的 功能 ， 下 面 列举 一 个 使 用 这 个 类 和 一 个 向 单数 组 
的 示例 。 


试 一 试 ”数组 和 局 级 集合 : Ch11Ex01 


(1) 在 C:\BeginningCSharp7\Chapterl1 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Chl1Ex01. 

(2) 在 Solution Explorer 窗口 中 右 击 项 目 ， 选 择 Add | Class HU, ZAIN AVS 3 个 新 类 : Animal. Cow 和 
Chicken. 

(3) 修改 Animal.cs 中 的 代码 ， 如 下 所 示 : 


namespace ChllEx01 


{ 
public abstract class Animal 
{ 


protected string name; 
public string Name 
{ 
get { return name; } 
set { name = value; } 
} 
public Animal() => name = "The animal with no name"; 


public Animal (string newName)=> name = newName; 
public void Feed() => WriteLine($"{name} has been fed.") ; 
} 
} 


(4) 修改 Cow.cs 中 的 代码 ， 如 下 所 示 : 


#112 


namespace Ch11Ex01 


{ 
public class Cow : Animal 
{ 
public void Milk() => WriteLine($"{name} has been milked."); 
public Cow(string newName) : base(newName) {} 
} 
} 


(5) 修改 Chicken.cs 中 的 代码 ， 如 下 所 示 : 


namespace Ch11Ex01 


{ 
public class Chicken : Animal 
{ 
public void LayEgg() => WriteLine($"{name} has laid an egg."); 
public Chicken(string newName) : base(newName) {} 
} 
} 


(6) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using System; 
using System.Collections; 
using System.Collections.Generic; 
using System.Linq; 
using System.Text; 
using System.Threading.Tasks; 
using static System.Console; 
namespace Ch11Ex01 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
WriteLine ("Create an Array type collection of Animal " + 
"objects and use it:"); 
Animal[] animalArray = new Animal [2]; 
Cow myCowl = new Cow("Lea"); 
animalArray[0] - myCow1; 
animalArray[1] = new Chicken("Noa"); 
foreach (Animal myAnimal in animalArray) 
1 
WriteLine($"New {myAnimal.ToString()} object added to Array" + 
$" collection, Name = (myAnimal.Name)"); 
) 


WriteLine($"Array collection contains {animalArray.Length} objects."); 


animalArray[0] .Feed() ; 

( (Chicken) animalArray[1]) .LayEggq() ; 

WriteLine(); 

WriteLine ("Create an ArrayList type collection of Animal " + 
"objects and use it:"); 

ArrayList animalArrayList — new ArrayList(); 

Cow myCow2 — new Cow("Donna"); 

animalArrayList.Add (myCow2); 

animalArrayList.Add(new Chicken ("Andrea") ) ; 

foreach (Animal myAnimal in animalArrayList) 

{ 

WriteLine($"New (myAnimal.ToString()) object added to ArrayList " + 
$" collection, Name = {myAnimal.Name}") ; 

} 

WriteLine($"ArrayList collection contains {animalArrayList.Count} " 
+ "ohjects.") ; 

((Animal)animalArrayList[0]).Feed(); 

( (Chicken) animalArrayList[1]) .LayEgg(); 

WriteLine(); 

WriteLine("Additional manipulation of ArrayList:"); 

animalArrayList.RemoveAt (0); 

( (Animal) animalArrayList[0]) .Feed(); 

animalArrayList.AddRange (animalArray) ; 

( (Chicken) animalArrayList[2]) .LayEgg(); 

WriteLine($"The animal called {myCowl.Name} is at " + 
$"index {animalArrayList.Indexof (myCowl)]."); 

myCowl.Name = "Mary"; 

WriteLine("The animal is now " + 
$" called (((Animal)animalArrayList[1]).Name )."); 

ReadKey () ; 
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(7) 运行 该 应 用 程序 ， 其 结果 如 图 11-1 所 示 。 


图 11-1 


示例 说 明 

这 个 示例 创建 了 两 个 对 象 集合 ， 第 一 个 集合 使 用 System.Array 类 (这 是 一 个 简单 数组 )， 第 二 个 集合 使 用 
System.Collections.ArrayList 类 。 这 两 个 集合 都 是 Animal 对 象 ， 都 在 Animal.cs 中 定义 。Animal 类 是 抽象 类 ， 所 
以 不 能 进行 实例 化 。 但 通过 多 态 性 ( 详 见 第 8 章 )， 可 使 集合 中 的 项 成 为 派生 于 Animal 类 的 Cow 和 Chicken 
类 实例 。 

在 Program.cs 的 Main0 方 法 中 创建 好 这 些 数 组 后 ， 束 可 以 显示 其 特性 和 功能 。 有 几 个 处 理 操作 可 应 用 到 
Array 和 ArrayList 集合 上 ， 但 它们 的 语法 略 有 区 别 。 也 有 一 些 操作 只 能 使 用 更 局 级 的 ArrayList 类 型 。 

下 面 首先 通过 比较 这 两 种 集合 类 型 的 代码 和 结果 ， 讨 论 一 下 类 似 操 作 。 首 先是 集合 的 创建 。 对 于 简单 数组 
而 言 , 只 有 用 固定 的 大 小 来 初始 化 数组 , 才能 使 用 它 。 下 面 使 用 第 5 草 介 绍 的 标准 语法 来 创建 数组 animalArray: 

Animal[] animalArray = new Animal[2]; 

而 ArrayList 集合 不 需 要 初始 化 其 大 小 ， 所 以 可 使 用 以 下 代码 创建 animal AmayList 列表 : 

ArrayList animalArrayList = new ArrayList (); 
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而 另 一 个 构造 函数 通过 一 个 参数 设置 集合 的 容量 (capacity)。 这 个 容量 用 一 个 int 值 指定 ， 用 于 设置 集合 中 可 以 
包含 的 初始 项 数 。 但 这 并 不 是 绝对 容量 ， 因 为 如 果 集 合 中 的 项 数 超过 了 这 个 值 ， 容 量 束 会 目 动 增加 一 倍 。 

因为 数组 是 引用 类 型 (例如 ，Animal F Animal 派生 的 对 象 )， 所 以 用 一 个 长 度 初 始 化 数组 并 没有 初始 化 它 所 
包含 的 项 。 要 使 用 一 个 指定 的 项 ， 该 项 还 青 要 初始 化 ， 即 需要 给 这 个 项 赋予 初始 化 了 的 对 象 : 

Cow myCowl = new Cow("Lea"); 

animalArray[0] = myCowl; 

animalArray[1] = new Chicken("Noa"); 

这 段 代码 以 两 种 方式 完成 该 初始 化 任务 ， 用 现 有 的 Cow 对 象 来 赋值 ， 或 者 通过 创建 一 个 新 的 Chicken WR 
来 赋值 。 主 要 区 别 在 于 前 者 引用 了 数组 中 的 对 象 一 一 我 们 在 代码 的 后 面 就 使 用 了 这 种 方式 。 

对 于 ArrayList 集合 , 它 没 有 现成 的 项 , 也 没有 null 引用 的 项 。 这 样 就 不 能 以 相同 的 方式 给 索引 赋予 新 实例 。 
我 们 使 用 ArrayList X RHI Add0 方 法 添加 新 项 : 

Cow myCow2 = new Cow("Donna"); 


animalArrayList.Add (myCow2); 
animalArrayList.Add(new Chicken("Andrea")); 
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除 语 法 稍 有 不 同 外 ， 还 可 以 采用 相同 的 方式 把 新 对 象 或 现 有 对 象 添 加 到 集合 中 。 以 这 种 方式 添加 完 项 后 ， 
就 可 以 使 用 与 数组 相同 的 语法 来 重 写 它 们 ， 例 如 ; 

animalArrayList[0] = new Cow ("Alma"); 

但 不 能 在 这 个 示例 中 这 么 做 。 

第 5 章 介 绍 了 了 如何 使 用 foreach 结构 迁 代 一 个 数组 。 这 是 可 以 的 ， 因 为 System.Array 类 实现 了 IEnumerable 
接口 ， 这 个 接口 的 唯一 方法 GetEnumerator0 可 以 迭代 集合 中 的 各 项 。 本 章 后 面 将 更 深入 地 讨论 这 一 点 。 在 代码 
中 ， 我 们 写 出 了 数组 中 每 个 Animal 对 象 的 信息 : 

foreach (Animal myAnimal in animalArray) 

i WriteLine($"New {myAnimal.ToString()} object added to Array " + 

$"collection, Name = {myAnimal.Name}"); 

这 里 使 用 的 ArrayList 对 象 也 文 持 IEnumerable 接口 ， 并 可 以 与 foreach 一 起 使 用 ， 此 时 语法 是 相同 的 : 

foreach (Animal myAnimal in animalArrayList) 

WriteLine($"New {myAnimal.ToString()} object added to ArrayList " + 


2"collection, Name = {myAnimal.Name}"); 


} 

接着 使 用 数组 的 Length 属性 ， 在 屏幕 上 输出 数组 中 元 素 的 个 数 : 

WriteLine($"Array collection contains {animalArray.Length} objects."); 

也 可 以 使 用 ArrayList 集合 得 到 相同 的 结果 ， 但 要 使 用 Count 属性 ， 该 属性 是 ICollection 接口 的 一 部 分 : 

WriteLine($"ArrayList collection contains {animalArrayList.Count} objects."); 

GRA BE UJ In] Se —— 76 Ve ze I] PACA ERR RIESA PIN, ETB A REB. MAHE 
强 类 型 化 的 ， 可 以 直接 访问 它们 所 包含 的 项 类 型 。 所 以 可 以 直接 调用 项 的 方法 : 

animalArray[0].Feed(); 

数组 的 类 型 是 抽象 类 型 Animal， 因 此 不 能 直接 调用 由 派生 类 提供 的 方法 ， 而 必须 使 用 数据 类 型 转换 ; 

((Chicken) animalArray[1]) .LayEgg(); 

ArrayList 集合 是 System.Object 对 象 的 集合 (通过 多 态 性 赋 给 Animal 对 和 象 )， 所 以 必须 对 所 有 的 项 进行 数据 
类 型 转换 ; 


( (Animal) animalArrayList[0]).Feed(); 
((Chicken)animalArrayList[1]).LayEgg(); 


代码 的 剩余 部 分 利用 的 一 些 ArrayList 集合 功能 超出 了 Aray 集合 的 功能 范围 。 首 先 ， 可 以 使 用 Remove() 
和 RemoveAtO 方 法 删除 项 ， 这 两 个 方法 是 在 ArrayList 类 中 实现 的 List 接口 的 一 部 分 。 它 们 分 别 根据 项 的 引用 
或 索引 从 数组 中 删除 项 。 本 例 使 用 后 一 种 方法 删除 列表 中 的 第 一 项 ， 即 Name 属性 为 Hayley 的 Cow 对 象 : 

animalArrayList.RemoveAt (0); 

另外 ， 还 可 以 使 用 

animalArraylist.Remove (myCow2); 

因为 这 个 对 象 已 经 有 一 个 本 地 引用 了 ， 所 以 可 以 通过 Add0 添 加 对 数组 的 一 个 现 有 引用 ， 而 不 是 创建 一 个 
新 对 象 。 无 论 采 用 哪 种 方式 ， 集 合 中 唯一 剩余 的 项 是 Chicken 对 象 ， 可 以 通过 以 下 方式 访问 它 : 

( (Animal) animalArrayList[0]).Feed(); 

当 对 ArrayList 对 象 中 的 项 进行 修改 ， 使 数组 中 剩 下 N 个 项 时 ， 其 索引 范围 将 变 为 0-N-1。 例 如 ,删除 索引 
为 0 的 项 ， 会 使 其 他 项 在 数组 中 移动 一 个 位 置 ， 所 以 应 使 用 索引 0( 而 非 D) 来 访问 Chicken 对 象 。 不 再 有 索引 为 
1 的 项 了 (因为 集合 中 最 初 只 有 两 个 项 )， 所 以 如 果 试 图 执行 下 面 的 代码 ， 束 会 抛 出 异 第 : 
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((Animal) animalArrayList[1]) .Feed(); 

ArrayList 集合 可 以 用 AddRange0 方 法 一 次 添加 好 几 项 。 这 个 方法 接受 高 有 [Collection 接口 的 任意 对 象 ， 包 
括 前 面 的 代码 所 创建 的 animalArray 数组 : 

animalArrayList.AddRange (animalArray); 


为 确定 这 是 否 有 效 ， 可 以 试 着 访问 集合 中 的 第 三 项 ， 它 将 是 animalAray 中 的 第 二 项 : 

((Chicken) animalArrayList[2]) .LayEgg(); 

AddRange0 方 法 不 是 ArrayList 提供 的 任何 接口 的 一 部 分 。 这 个 方法 专用 于 ArrayList 类 ， 证 实 了 可 以 在 集 
合 类 中 执行 定制 操作 , 而 不 仅 是 前 面 介 绍 的 接口 要 求 的 操作 。 这 个 类 还 提供 了 其 他 有 趣 的 方法 , 如 InsertRange0)， 
它 可 以 把 数组 对 象 插入 到 列表 中 的 任何 位 置 ， 还 有 用 于 排序 和 重新 排序 数组 的 方法 。 

最 后 ,再 回头 来 看 看 对 同一 个 对 象 进 行 多 个 引用 。 使 用 List 接口 中 的 mdexOfO 方 法 可 以 看 出 , myCow1( 最 
初 添加 到 animalArray 中 的 一 个 对 象 ) 现 在 是 animalArrayList 集合 的 一 部 分 ， 它 的 案 引 如 下 : 


WriteLine($"The animal called {myCowl.Name} is at index ”十 
S"{animalArrayList.Indexof (myCowl)}."); 


例如 ， 接 下 来 的 两 行 代码 通过 对 象 引 用 重新 命名 了 对 象 ， 并 通过 集合 引用 显示 了 新 名 称 : 


myCowl.Name = "Mary"; 
WriteLine($"The animal is now called [((Animal)animalArrayList[1]).Name].") 


111.2 定义 集合 


前 和 面 介绍 了 使 用 局 级 集合 类 能 完成 什么 任务 ， 下 和 面 讨论 如 何 创 建 自己 的 强 类 型 化 的 集合 。 一 种 方式 是 手动 
实现 需要 的 方法 ， 但 这 较 费 时 间 而 且 过 程 也 非常 复杂 。 我 们 还 可 以 从 一 个 类 中 派生 目 己 的 集合 ， 例 如 
System.Collections.CollectionBase 类 ， 这 个 抽象 类 提供 了 集合 类 的 大 量 实现 代码 。 这 是 推荐 使 用 的 方式 。 

CollectionBase 类 有 接口 焉 numerable、ICollection 和 IList， 但 只 提供 了 一 些 必 要 的 实现 代码 ， 主 要 是 List 
的 Clear0 和 RemoveAt0O 方 法 ， 以 及 [Collection 的 Count 属性 。 如 果 要 使 用 提供 的 功能 ， 就 需要 目 己 实现 其 他 
代码 。 

为 便于 完成 任务 ，CollectionBase 提供 了 两 个 受 你 护 的 属性 ， 它 们 可 以 访问 所 存储 的 对 象 本 号 。 我 们 可 以 使 
用 List 和 InnerList, List 可 以 通过 Mist 接口 访问 项 ，InnerList 则 是 用 于 存储 项 的 ArrayList XR. 

例如 ， 和 存储 Animal 对 象 的 集合 类 可 以 定义 如 下 ( 稍 后 介绍 较 完 整 的 实现 代码 ): 


public class Animals : CollectionBase 

{ 
public void Add (Animal newAnimal) => List.Add(newAnimal); 
public void Remove (Animal oldAnimal) => List.Remove (oldAnimal); 


public Animals() {} 


其 中 ，Add0 和 Remove0 方 法 已 实现 为 强 类 型 的 方法 ， 使 用 IList 接口 的 标准 Add0 方 法 来 访问 项 。 这 些 方 
法 现在 只 用 于 处 理 Animal 类 或 派生 于 Animal 的 类 ， 而 前 面 介 绍 的 ArrayList 实现 代码 可 处 理 任 何 对 象 。 
CollectionBase 类 可 以 对 派生 的 集合 使 用 foreach 语法 。 例 如 ， 可 使 用 下 面 的 代码 : 


WriteLine ("Using custom collection class Animals:"); 
Animals animalCollection = new Animals(); 
animalCcollection.Add (new Cow("Lea")); 

foreach (Animal myAnimal in animalCollection) 


WriteLine($"New { myAnimal.ToString()} object added to custom " + 
S5"collection, Name = {myAnimal.Name}"); 
} 
但 不 能 使 用 下 面 的 代码 : 


animalCollection[0].Feed(); 
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要 以 这 种 方式 通过 索引 来 访问 项 ， 束 需要 使 用 索引 符 。 


11.1.3 索引 符 


索引 和 从 (indexen) 是 一 种 特殊 的 属性 ， 可 以 把 它 添加 到 一 个 类 中 ， 以 提供 类 似 于 数组 的 访问 。 实 际 上 ， 可 通 
过 索引 符 提 供 更 复 林 的 访问 ， 因 为 我 们 可 以 用 方 括号 语法 来 定义 和 使 用 复杂 的 参数 类 型 。 它 最 单 见 的 一 个 用 法 
是 对 项 实现 简单 的 数字 索引 。 

可 以 在 Animal 对 象 的 Animals 集合 中 添加 一 个 索引 符 ， 如 下 所 示 : 


public class Animals : CollectionBase 
{ 
public Animal this[int animalIndex] 
{ 
get { return (Animal)List[animalIndex]; } 
Set [ List[animallIndex] = value; } 
} 
} 


this 关键 字 需 要 与 方 括号 中 的 参数 一 起 使 用 ， 除 此 以 外 ， 索 引 符 与 其 他 属性 十 分 类 似 。 这 个 语法 是 合理 
的 ， 因 为 在 访问 索引 符 时 ， 将 使 用 对 象 名 ， 后 跟 放 在 方 括号 中 的 索引 参数 (例如 MyAnimals[0])。 

这 段 代码 对 List 属性 使 用 了 一 个 索引 符 ( 即 在 IList 接口 上 , 可 以 访问 CollectionBase 中 的 ArrayList, ArrayList 
存储 了 项 ): 

return (Animal)List[animalIndex]; 

这 里 需要 进行 显 式 数据 类 型 转换 ， 因 为 IList.List 属性 返回 一 个 System.Object 对 象 。 注 意 ， 我 们 为 这 个 索 
引 符 定义 了 一 个 类 型 。 使 用 该 索引 符 访问 某 项 时 ， 就 可 以 得 到 这 个 类 型 。 这 种 强 类 型 化 功能 意味 着 ， 可 以 编写 
下 述 代码 : 

animalCollection[0].Feed(); 

而 不 是 : 

((Animal)animalCollection[0]).Feed(); 


这 是 强 类 型 化 的 定制 集合 的 另 一 个 方便 特性 。 下 面 扩 展 上 一 个 示例 ， 实 践 一 下 该 特性 。 


试 一 试 ” 实 现 Animals 集合 : Ch11Ex02 


(1) 在 C:\BeginningCSharp7\Chapterl1 目录 中 创建 一 个 新 控制 台 应 用 程序 Ch11Ex02。 

(2) 在 Solution Explorer 窗口 中 右 击 项 目 名 ， 选 择 Add | Existing Item 选项 。 

(3) 从 C:\BeginningCSharp7\Chapter11\Ch11Ex01 目录 中 选择 Animales. Cow.cs 和 Chicken.cs 文件 ， 单 击 Add 
按钮 。 

(4) 修改 这 3 个 文件 中 的 名 称 空间 声明 ， 如 下 所 示 : 

namespace ChllEx02 

(5) 添加 一 个 新 类 Animals. 

(6) 修改 Animals.cs 中 的 代码 ， 如 下 所 示 : 


using System; 
using System.Collections; 
using System.Collections.Generic; 
using System.Linq; 
using System.Text; 
using System. Threading. Tasks; 
namespace ChllEx02 
{ 
public class Animals : CollectionBase 


public void Add(Animal newAnimal) => 
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List.Add(newAnimal); 


public void Remove (Animal newAnimal) => 
List.Remove (newAnimal); 


public Animal this[int animalIndex] 
i 
get { return (Animal)List[animalIndex]; } 
set { List[animalIndex] = value; } 
) 
} 
} 


(7) 修改 Program.cs, WN ATA: 


static void Main(string[] args) 

i 
Animals animalCollection - new Animals(); 
animalCollection.Add(new Cow("Donna")); 
animalCollection.Add(new Chicken("Mary")); 
foreach (Animal myAnimal in animalCollection) 
{ 

myAnimal . Feed () ; 

} 
ReadKey () ; 

} 


(8) 执行 该 应 用 程序 ， 其 结果 如 图 11-2 所 示 。 


示例 说 明 

这 个 示例 使 用 上 一 节 详 细 介绍 的 代码 ， 实 现 Animals 类 中 强 类 型 化 的 Animal 对 象 集合 。Main0 中 的 代码 仅 
实例 化 了 一 个 Animals 对 象 animalCollection, 添加 了 两 个 项 (它们 分 别 是 Cow F Chicken 的 实例 ), 并 使 用 foreach 
循环 来 调用 这 两 个 对 象 继 承 于 基 类 Animal 的 Feed0 方 法 。 


11.1.4 给 CardLib 添加 Cards 集合 


第 10 半 创建 了 一 个 类 库 项 目 Ch10CardLib, 它 包含 一 个 表示 扑克 牌 的 Card 类 和 一 个 表示 一 副 扑克 有 牌 的 Deck 
类 ， 这 个 Deck 类 是 Card 类 的 集合 ， 且 实现 为 一 个 简单 数组 。 

本 章 给 这 个 库 添加 一 个 新 类 ， 并 将 该 库 重 命 名 为 Ch11CardLib。 这 个 新 类 Cards 是 Card 对 象 的 一 个 定制 集 
合 ， 并 拥有 本 章 前 面 介绍 的 各 种 功能 。 在 C:\BeginningCSharp7\Chapterll 目录 中 创建 一 个 新 的 类 库 Ch11CardLib。 
然后 删除 目 动 生成 的 Classl.es 文件 ， 再 通过 Project | Add Existing Item 命令 选择 C:\BeginningCSharp7\Chapter10\ 
ChlOCardLib 目录 中 的 Card.cs、Deck.cs、Suit.cs 和 Rank.cs 文件 ， 把 它们 添加 到 项 目 中 。 与 第 10 章 介绍 的 这 个 项 
目的 上 一 个 版 本 相同 ， 这 里 不 再 使 用 标准 的 “ 试 一 试 ”格式 介绍 这 些 变化 。 读 者 可 在 本 章 的 下 载 代码 中 打开 这 
个 项 目 ， 直 接 得 看 代码 。 


注意 : 
在 把 源 文 件 从 Ch10CardLib 复制 到 ChllCardLib 中 时 ， 必 须 修改 名 称 空间 声明 ， 以 引用 ChllCardLib. * FI 
于 测试 的 Ch10CardClient 控制 台 应 用 程序 ， 也 要 进行 这 个 修改 。 


本 章 下 载 代码 中 的 ChllCardLib 文件 夹 包含 对 ChlICardLib 项 目 进行 的 各 种 扩展 。 因 此 ， 读 者 可 能 会 注意 
到 一 些 本 例 没 有 用 到 的 代码 ， 不 过 它们 并 不 影响 这 里 介绍 的 内 容 。 很 多 这 样 的 代码 都 被 注释 挥 了 ， 不 过 当 学 习 
相关 示例 时 ， 可 以 取消 对 相应 代码 部 分 的 注释 。 

如 果 要 上 日 己 创建 这 个 项 目 ， 就 应 添加 一 个 新 类 Cards， 并 修改 Cards.cs 中 的 代码 ， 如 下 所 示 : 
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using System; 

using System.Collections; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System. Threading. Tasks; 
namespace ChllCardLib 


{ 


public class Cards : CollectionBase 


{ 


} 
} 


public void Add(Card newCard) => List.Add(newCard) ; 
public void Remove (Card oldCard) => List.Remove (oldCard) ; 


public Card this[int cardIndex] 
{ 
get { return (Card) List[cardIndex]; } 
set { List[cardIndex] = value; } 
} 
/// <summary> 
/// Utility method for copying card instances into another Cards 
/// instance—used in Deck.Shuffle(). This implementation assumes that 
/// source and target collections are the same size. 
/// </summary> 
public void CopyTo(Cards targetCards) 


{ 
for (int index = 0; index < this.Count; index+t) 
{ 
targetcCards [index] = this[index]; 
} 
} 


/// <summary> 

/// Check to see if the Cards collection contains a particular card. 
/// This calls the Contains() method of the ArrayList for the collection, 
/// which you access through the InnerList property. 

/// </summary> 

public bool Contains(Card card) => InnerList.Contains (card); 


然后 需要 修改 Deckcs， 以 利用 这 个 新 集合 (而 不 是 数组 ): 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

namespace ChllCardLib 


{ 


public class Deck 


{ 


private Cards cards = new Cards (); 
public Deck () 


{ 
// Line of code removed here 
for (int suitVal = 0; suitVal « 4; suitVal++) 
{ 
for (int rankVal = 1; rankVal < 14; rankVal++) 
{ 
cards .Add(new Card((Suit)suitVal, (Rank) rankVal)); 
} 
} 
} 
public Card GetCard(int cardNum) 
{ 
if (cardNum >= 0 && cardNum <= 51) 
return cards[cardNum]; 
else 
throw (new System.ArgumentOutOfRangeException("cardNum", cardNum, 
"Value must be between 0 and 51.")); 
} 
public void Shuffle () 
{ 


Cards newDeck = new Cards(); 
bool[] assigned = new bool[52]; 
Random sourceGen = new Random(); 
for (int 1 = 0; 1 < 52; i++) 
{ 


int sourceCard = 0; 
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bool foundCard = false; 
while (foundCard == false) 
sourceCard = sourceGen.Next (52); 
if (assigned[sourceCard] — false) 
foundCard - true; 
—— = true; 
newDeck.Add (cards [sourceCard]); 
— ae 
} 
} 
} 
在 此 不 需要 做 很 多 修改 。 其 中 大 多 数 修改 部 涉 及 改变 洗 有 牌 逻 辑 ， 才 能 把 cards "P BELT) — SKS JUD 
Cards 集合 newDeck 的 开头 ， 而 不 是 把 cards 集合 中 顺序 位 置 的 一 张 牌 添加 newDeck 集合 的 随机 位 置 上 。 
ChlOCardLib 解决 方案 的 客户 控制 台 应 用 程序 Ch10CardClient 可 使 用 这 个 新 库 得 到 与 以 前 相同 的 结果 ， 因 
为 Deck 的 方法 签名 没有 改变 。 这 个 类 库 的 客户 程序 现在 可 以 使 用 Cards 集合 类， 而 不 是 依赖 于 Card 对 象 数组 ， 


例如 ， 在 扑克 有 牌 游 戏 应 用 程序 中 定义 一 手 牌 。 


11.1.5 RAM |Dictionary 


除 实现 List 接口 外 ， 集 合 还 可 以 实现 类 似 的 IDictionary 接口 ， 人 允许 项 通过 键 值 (如 字符 串 名 ) 进 行 索引 ， 而 
不 是 通过 一 个 索引 。 这 也 可 以 使 用 索引 符 来 完成 ， 但 这 次 使 用 的 索引 符 参 数 是 一 个 与 存储 的 项 相关 联 的 键 ， 而 
不 是 int 索引 ， 这 样 集合 就 更 便于 用 户 使 用 了 。 

与 索引 的 集合 一 样 ， 可 使 用 一 个 其 类 简化 Dictionary 接口 的 实现 ， 这 个 基 类 就 是 DictionaryBase， 它 也 实 
现 IEnumerable 和 ICollection， 提 供 了 对 任何 集合 都 相同 的 基本 集合 处 理 功 能 。 

与 CollectionBase 一 样 ，DictionaryBase 也 实现 通过 其 文 持 的 接口 获得 的 一 些 成 员 ( 但 不 是 全 部 成 员 )。 
DictionaryBase 也 实现 Clear 和 Count 成 员 ， 但 不 实现 RemoveAtO。 这 是 因为 RemoveAtO 是 IList 接口 中 的 一 个 
方法 ， 而 不 是 IDictionary 接口 中 的 一 个 方法 。 但 是 ，IDictionary 有 一 个 Remove0 方 法 ， 这 是 一 个 应 在 基于 
DictionaryBase 的 定制 集合 类 上 实现 的 方法 。 

下 面 的 代码 是 Animals 类 的 另 一 个 古本， 这 次 该 类 派生 于 DictionaryBase。 这 段 代 码 包括 Add(). Remove() 
和 一 个 通过 键 访 问 的 索引 符 的 实现 代码 : 

public class Animals : DictionaryBase 

{ 


public void Add(string newID, Animal newAnimal) => 
Dictionary.Add(newID, newAnimal); 


public void Remove(string animalID) => 
Dictionary.Remove (animalID); 


public Animals() {} 
public Animal this[string animalID] 
get { return (Animal)Dictionary[animalID]; ) 
set { Dictionary[animalID] = value; } 
] i 
这 些 成 员 的 区 别 如 下 : 
e Add0 一 一 带 有 两 个 参数 : 一 个 键 和 一 个 值 ， 存 储 在 一 起 。 字 典 集合 有 一 个 继承 于 DictionaryBase 的 成 员 
Dictionary， 这 个 成 员 是 一 个 IDictionary 接口 ， 有 上 自己 的 Add0 方 法 ， 该 方法 带 有 两 个 object 参数 。 我 们 
的 实现 代码 使 用 一 个 string 值 作为 键 ， 使 用 一 个 Animal 对 象 作 为 与 该 键 存 储 在 一 起 的 数据 。 
e Remove() 一 -以 一 个 键 (而 不 是 对 象 引用 ) 作 为 参数 。 删 除 与 指定 键 值 相对 应 的 项 。 
e Indexer 一 一 使 用 一 个 字符 串 键 值 , 而 不 是 一 个 索引 , 用 于 通过 Dictionary 的 继承 成 员 来 访问 所 存储 的 项 ， 
基于 DictionaryBase 的 集合 和 基于 CollectionBase 的 集合 之 间 的 另 一 个 区 别 是 foreach 的 工作 方式 稍 有 区 
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别 。 上 一 节 中 的 集合 可 以 直接 从 集合 中 提取 Animal 对 象 。 使 用 foreach 和 DictionaryBase 派生 类 可 以 提供 

DictionaryEntry 结构 ， 这 是 男 一 个 在 System.Collections 名 称 空间 中 定义 的 类 型 。 要 得 到 Animal 对 象 本 身 ， 就 必 

须 使 用 这 个 结构 的 Value 成 员 ， 也 可 以 使 用 结构 的 Key 成 员 得 到 相关 的 键 。 要 使 代码 等 价 于 前 面 的 代码 ; 
foreach (Animal myAnimal in animalCollection) 


WriteLine ($"New [myAnimal.ToString()) object added to custom ™ + 
S5"collection, Name = {myAnimal.Name}"); 


} 
需要 使 用 以 下 代码 : 
foreach (DictionaryEntry myEntry in animalCollection) 


WriteLine($"New {myEntry.Value.ToString()} object added to ™ + 
5"custom collection, Name = [((Animal)myEntry.Value).Name]"); 


] 
可 以 采用 许多 方式 来 重 写 这 段 代码 ， 以 便 直接 通过 foreach 访问 Animal 对 象 ， 其 中 最 简单 的 方式 是 实现 一 
ENCE 


11.1.6 ZRA 


本 草 前 面 介 绍 过 ，IEnumerable 接口 允许 使 用 foreach 循环 。 在 foreach 循环 中 并 不 是 只 能 使 用 集合 类 (如 本 
章 前 面 所 示 的 几 个 集合 类 )， 相 反 ， 在 foreach 循环 中 使 用 定制 类 通常 有 很 多 优点 。 

但 是 ， 重 写 使 用 foreach 循环 的 方式 或 者 提供 定制 的 实现 方式 并 不 一 定 很 简单 。 为 了 说 明 这 一 点 ， 下 面 有 必 
要 深入 人 研究 一 下 foreach 循环 。 在 foreach 循环 中 ， 运 代 一 个 collectionObject 集合 的 过 程 如 下 : 

(1) 调用 collectionObjectGetEnumerator0， 返 回 一 个 IEnumerator 引 用 。 这 个 方法 可 通过 IFEnumerable 接 口 的 
实现 代码 来 获得 ， 但 这 是 可 选 的 。 

(2) 调用 所 返回 的 IEnumerator 接口 的 MoveNextO7; iX» 

(3) 如 果 MoveNextO 方 法 返回 true， 就 使 用 IEnumerator 接口 的 Current 属性 来 获取 对 象 的 一 个 引用 ， 用 于 
foreach (83^. 

(4) 重复 前 面 两 步 ， 直 到 MoveNextO 方 法 返回 false 为 止 ， 此 时 循环 停止 。 

所 以 ， 为 在 类 中 进行 这 些 操作 ， 必 须 重 写 几 个 方法 ， 跟踪 索引 ,维护 Current 属性 ， 以 及 执行 其 他 一 些 操作 。 
这 要 做 许多 工作 。 

一 个 较 简 单 的 蔡 代 方法 是 使 用 迭代 器 。 使 用 友 代 堪 将 有 效 地 目 动 生成 许多 代码 ， 正 确 地 完成 所 有 任务 。 而 
且 ， 使 用 友 代 器 的 语法 擎 握 起 来 非 营 容易 。 

迭代 器 的 定义 是 ， 它 是 一 个 代码 块 ， 按 顺序 提供 了 要 在 foreach 块 中 使 用 的 所 有 值 。 一 般 情 况 下 ， 这 个 代码 
块 是 一 个 方法 ， 但 也 可 以 使 用 属性 访问 右 和 其 他 代码 块 作为 迁 代 右 。 这 里 为 简单 起 见 ， 仅 介绍 方法 。 

无 论 代码 块 是 什么 ,其 返回 类 型 都 是 有 限制 的 。 与 期 望 正好 相反 ， 这 个 返回 类 型 与 所 枚 举 的 对 象 类 型 不 同 。 
例如 ， 在 表示 Animal 对 象 集合 的 类 中 ， 连 代 器 块 的 返回 类 型 不 可 能 是 Animal。 两 种 可 能 的 返回 类 型 是 表面 提 
到 的 接口 类 型 : IEnumerable 和 IEnumerator。 使 用 这 两 种 类 型 的 场合 是 : 

e 如 条 要 友 代 一 个 类 ， 则 使 用 方法 GetEnumerator0， 其 返回 类 型 是 IEnumerator. 

e 如 条 要 友 代 一 个 类 成 员 ， 例 如 一 个 方法 ， 则 使 用 Enumerable. 

在 迭代 器 块 中 ， 使 用 yield 关键 字 选 择 要 在 foreach 循环 中 使 用 的 值 。 其 语法 如 下 : 

yield return <value>; 

AHRNE Re EEA i I as Bl, OB PAN QS Bl hE RAS 9C fF. Simplelterators\ 
Program.cs 中 ): 


public static IEnumerable SimpleList() 


yield return "string 1"; 
yield return "string 2"; 
yield return "string 3"; 
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} 


static void Main(string[] args) 
{ 
foreach (string item in SimpleList()) 
WriteLine (item); 
ReadKey () ; 
} 


在 此 ， 评 态 方法 SimpleList0 束 是 迭代 器 块 。 它 是 一 个 方法 ， 所 以 使 用 下 numerable 返回 类 型 。SimpleListO 
使 用 yield 关键 字 为 使 用 它 的 foreach 块 提供 了 3 个 值 ， 每 个 值 都 输出 到 屏幕 上 ， 结 果 如 图 11-3 所 示 。 


图 11-3 


显然 ， 这 个 迭代 器 并 不 是 特别 有 用 ， 但 它 确实 能 够 演示 返 代 器 的 机 制 ， 说 明 实 现 运 代 器 有 多 人 么 简单 。 看 看 
代码 ， 读 者 可 能 会 疑惑 代码 是 如 何 知 道 返回 string 类 型 的 项 。 实 际 上 ， 并 没有 返回 string 类 型 的 项 ， 而 是 返回 
object 类 型 的 值 。 因 为 object 是 所 有 类 型 的 基 类 ， 所 以 可 从 yield 语句 中 返回 任意 类 型 。 

但 编译 器 的 智能 程度 很 高 ,所 以 我 们 可 以 把 返回 值 解释 为 foreach 循环 需要 的 任何 类 型 .这 里 代码 需要 string 
类 型 的 值 ， 而 这 正 是 我 们 要 使 用 的 值 。 如 果 修 改 一 行 yield 代码 ， 让 它 返 回 一 个 整数 ， 就 会 在 foreach 循环 中 出 
现 一 个 类 型 转换 异常 。 

对 于 迭代 器 ， 还 有 一 点 要 注意 。 可 以 使 用 下 面 的 语句 中 断 将 信息 返回 给 foreach 循环 的 过 程 : 


yield break; 


TES BIA as FIR Sa AY, EA ee a BUST, TEAR AIAN RIT foreach 循环 也 一 样 。 
PEM ARERR AINA DU. dEXX SAN, SESCHU “Aa, RRA 


i—iX BREAK: Ch11Ex03 


(1) 在 C:\BeginningCSharp7\Chapterll 目录 中 创建 一 个 新 控制 台 应 用 程序 Ch11Ex03. 
(2) 添加 一 个 新 类 Primes， 修 改 Primes.cs 中 的 代码 ， 如 下 所 示 : 


using System; 

using System.Collections; 

using System.Collections.Generic; 
using System. Ling; 

using System.Text; 

using System. Threading.Tasks; 
namespace ChllEx03 


public class Primes 
{ 
private long min; 
private long max; 
public Primes() : this(2, 100) {} 
public Primes (long minimum, long maximum) 
{ 


if (minimum < 2) 


} 
public IEnumerator GetEnumerator () 
{ 
for (long possiblePrime = min; possiblePrime <= max; possiblePrime++) 
{ 
bool isPrime = true; 
for (long possibleFactor = 2; possibleFactor <= 
(long) Math. Floor (Math.Sqrt(possiblePrime)); possibleFactor++) 


long remainderAfterDivision = possiblePrime % possibleFactor; 
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if (remainderAfterDivision == 0) 


{ 
isPrime = false; 
break; 
} 
if (isPrime) 
yield return possiblePrime; 
} 


} 
} 
} 
} 


(3) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


static void Main(string[] args) 


{ 
Primes primesFrom2Tol000 = new Primes(2, 1000); 
foreach (long i in primesFrom2To1000) 
Write($"(i) "); 
ReadKey () ; 
] 


(4) 执行 该 应 用 程序 ， 结 果 如 图 11-4 所 示 。 


示例 说 明 

这 个 示例 中 的 类 可 以 枚 举 上 下 限 之 间 的 素数 集合 。 封 闻 素 数 的 类 利用 友 代 器 提供 了 这 个 功能 。 

Primes 的 代码 开始 时 比较 简单 ， 用 两 个 字段 来 存储 表示 搜索 范围 的 最 大 值 和 最 小 值 ， 并 使 用 构造 函数 设置 
这 些 值 。 注 意 ， 最 小 值 是 有 限制 的 ， 它 不 能 小 于 2， 这 很 合理 ， 因 为 2 是 最 小 的 素数 。 相 关 的 代码 则 全 部 放 
在 方法 GetEnumerator0 中 。 该 方法 的 签名 满足 迭代 器 块 的 规则 ， 因 为 它 返回 Enumerator 类 型 ; 


public IEnumerator GetEnumerator ( ) 


{ 
为 提取 上 下 限 之 间 的 系数 ， 需 要 依次 测试 每 个 值 ， 所 以 用 一 个 for 循环 开始 : 
for (long possiblePrime = min; possiblePrime <= max; possiblePrime++) 
{ 
FF AAR PCE ERE AUTRE TAER HAACEERERA. AM, HRAA 
VRBE td 2 到 该 数 平方 根 之 间 的 所 有 数 整 除 。 如 果 能 ， 则 该 数 不 是 素数 ， 于 是 测试 下 一 个 数 。 如 果 该 数 的 确 
ERM, DAE yield 把 它 传送 给 foreach 循环 。 


bool isPrime = true; 
for (long possibleFactor = 2; possibleFactor <= 
(long) Math.Floor (Math.Sqrt (possiblePrime)); possibleFactor++) 
{ 
long remainderAfterDivision = possiblePrime % possibleFactor; 
if (remainderAfterDivision == 0) 


{ 
isPrime = false; 
break; 
} 
if (isPrime) 
i 
yield return possiblePrime; 
} 


} 
} 
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这 段 代 码 有 一 个 有 趣 之 处 ， 如 果 把 上 下 限 设置 为 非常 大 的 数 ， 在 执行 应 用 程序 时 ， 就 会 发 现 ， 会 一 次 显示 
一 个 结果 ， 中 间 有 暂停 ， 而 不 是 一 次 显示 所 有 结果 。 这 说 明 ， 无 论 代码 在 yield WAZ LEAH, BARE 
都 会 一 次 返回 一 个 结果 。 在 后 台 ， 调 用 yield 都 会 中 断代 码 的 执行 ， 当 请 求 另 一 个 值 时 ， 也 就 是 当 使 用 迭代 器 的 
foreach 循环 开始 一 个 新 循环 时 ， 代 码 会 恢复 执行 。 


11.1.7 ARAMES 


HUM SEF, AITA IAT ae UU el A SE SA RA PRR R, mAb Dictionaryltem 对 
象 。 在 本 章 下 载 代码 的 DictionaryAnimals 文件 赤 中 ， 可 以 找到 接 下 来 这 个 项 目的 代码 。 下 面 是 集合 类 Animals: 


public class Animals : DictionaryBase 
{ 
public void Add(string newID, Animal newAnimal) => 
Dictionary.Add(newID, newAnimal); 


public void Remove(string animalID) => 
Dictionary .Remove (animalID); 


public Animal this[string animalID] 
{ 
get { return (Animal)Dictionary[animalID]; } 
set { Dictionary[animalID] = value; } 
} 
} 


可 在 这 段 代 码 中 添加 如 下 的 简单 碗 代 器 ， 以 便 执 行 预 期 的 操作 : 
public new IEnumerator GetEnumerator () 


foreach (object animal in Dictionary.Values) 
yield return (Animal) animal; 


} 
现在 可 使 用 下 面 的 代码 来 迭代 集合 中 的 Animal 对 象 : 


foreach (Animal myAnimal in animalCollection) 
{ 
WriteLine($"New {myAnimal.ToString()} object added to ”十 
$" custom collection, Name = {myAnimal.Name}"); 


11.4.8. 深度 复制 


第 9 章 通 过 下 面 的 GetCopy0 方 法 ， 介 绍 了 如 何 使 用 受 保 护 的 方法 System.ObjectMemberwiseCloneO 进 行 浅 度 
复制 。 


public class Cloner 
{ 
public int Val; 
public Cloner(int newVal) => Val = newVal; 
public object GetCopy() => MemberwiseClone (); 
} 
假定 有 一 些 引 用 类 型 的 字段 ， 而 不 是 值 类 型 的 字段 (例如 ， 对 象 ): 


Public class Content 
{ 
public int Val; 
} 
public class Cloner 
{ 
public Content MyContent = new Content () ; 
public Cloner(int newVal) => MyContent.Val = newVal; 
public object GetCopy() => MemberwiseClone(); 


此 时 , 通过 GetCopy0 得 到 的 浅 度 复制 包括 一 个 字段 , 它 引 用 的 对 象 与 源 对 象 相同 。 以 下 代 人 码 使 用 这 个 Cloner 
类 来 说 明 浅 度 复制 引用 类 型 的 结果 : 
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Cloner mySource = new Cloner(5); 

Cloner myTarget = (Cloner)mySource.GetCopy(); 
WriteLine($"myTarget.MyContent.Val = {myTarget.MyContent.Val}"); 
mySource.MyContent.Val = 2; 

WriteLine ($"myTarget .MyContent.Val = {myTarget.MyContent.Val}"); 


第 4 行 把 一 个 值 赋 给 mySource.MyContent.Val， 它 是 源 对 象 中 公共 字段 MyContent 的 公共 字段 Val。 这 也 改 
A f myTarget.MyContent. Val 的 值 。 这 是 因为 nie 引用 了 与 myTarget.MyContent 相同 的 对 象 
实例 。 上 述 代码 的 输出 结果 如 下 : 


5 
2 


myTarget.MyContent.Val 
myTarget.MyContent.Val 


为 解决 这 个 问题 ， 需 要 执行 深度 复制 。 修 改 上 面 的 GetCopy0 方 法 就 可 以 进行 深度 复制 ， 但 最 好 使 用 NET 
Framework 的 标准 方式 : 实现 ICloneable 接口 ， 该 接口 有 一 个 Clone0) 方 法 ; 这 个 方法 不 带 参数 , 返回 一 个 object 
类 型 的 结束 ， 其 使 名 和 上 面 使 用 的 GetCopy0 方 法 相同 。 

为 修改 上 面 的 类 ， 可 使 用 下 面 的 深度 复制 代码 : 


public class Content 
{ 
public int Val; 
} 
public class Cloner : ICloneable 


public Content MyContent = new Content (); 

public Cloner(int newVal) => MyContent.Val = newVal; 

public object Clone () 

{ 
Cloner clonedCloner = new Cloner (MyContent.Val); 
return clonedcloner; 

) 

} 


其 中 使 用 包含 在 源 Cloner 对 象 中 的 Content Xj £(MyContent)If] Val 字段 ， 创 建 了 一 个 新 对 象 Cloner. 17 
字段 是 一 个 值 类 型 ， 所 以 不 需要 深度 复制 。 
使 用 与 上 和 面 类 似 的 代码 来 测试 浅 度 复制 ， 但 用 Clone0 蔡 代 GetCopy0， 得 到 如 下 结果 : 


9 
9 


myTarget.MyContent.Val 
myTarget.MyContent.Val 


这 次 包含 的 对 象 是 独立 的 。 注 意 有 时 在 比较 复杂 的 对 象 系统 中 ， 调 用 Clone0 是 一 个 递归 过 程 。 例 如 ， 如 果 
Cloner 类 的 MyContent 字段 也 需要 深度 复制 ， 就 要 使 用 下 面 的 代码 : 


public class Cloner : ICloneable 


{ 
public Content MyContent = new Content (); 


public object Clone () 
{ 
Cloner clonedCloner = new Cloner (); 
clonedCloner.MyContent = MyContent.Clone(); 
return clonedCloner; 
} 
} 


Content 类 上 实现 ICloneable 接口 。 
11.1.9 给 CardLib 添加 深度 复制 


下 和 面 把 上 述 内 容 付 语 于 实践 :使 用 ICloneable 接口 ， 复 制 Card. Cards 和 Deck 对 象 ， 这 在 某 些 扑克 有 牌 洲 
戏 中 是 有 用 的 , 因为 在 这 些 游戏 中 不 需要 让 两 副 扑 克 牌 引用 同一 组 Card 对 象 , 但 肯定 会 使 一 副 扑 克 牌 中 的 牌 订 
5553 — iU RES RÉF RH Fe] 

f£ ChllCardLib 中 ， 对 Card 关 执 行 复制 操作 是 很 简单 的 ， 因 为 只 需要 进行 浅 度 复制 (Card 只 包含 值 类 型 的 
数据 ， 其 形式 为 字段 )。 我 们 只 需要 对 类 定义 进行 如 下 修改 : 
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public class Card : ICloneable 
{ 
public object Clone() => MemberwiseClone() ; 


ICloneable 接口 的 这 段 实现 代码 只 是 一 个 浅 度 复制 ， 无 法 确定 在 Clone0 方 法 中 执行 了 什么 操作 ， 但 这 已 经 
足以 满足 我 们 的 需要 。 

接着 , 需要 对 Cards 集合 类 实现 ICloneable 接口 。 这 个 过 程 稍 复 洒 些 , 因为 涉及 到 复制 源 集合 中 的 每 个 Card 
对 象 ， 所 以 需要 进行 深度 复制 


public class Cards : CollectionBase, ICloneable 


public object Clone () 
Cards newCards = new Cards(); 
foreach (Card sourceCard in List) 
newCards .Add( (Card) sourceCard.Clone()); 
T newCards; 
) 


最 后 ， 需 要 在 Deck 类 上 实现 ICloneable 接口 。 这 里 存在 一 个 小 问题 : 因为 Chl1CardLib 中 的 Deck 类 无 法 
EAEE SIFE. MARAE. Mu, TAEA R ERT H Deck 实例 。 为 解决 这 个 问题 ， 为 Deck 
类 定义 一 个 新 的 私有 构造 函数 ， 在 实例 化 Deck 对 象 时 ， 可 以 给 该 函数 传递 一 个 特定 的 Cards 集合 。 所 以 ， 在 这 
个 类 中 执行 复制 的 代码 如 下 所 示 : 


public class Deck : ICloneable 
public object Clone () 
Deck newDeck = new Deck (cards.Clone() as Cards); 
return newDeck; 
aie Deck (Cards newCards) => cards = newCards; 


再 次 用 一 些 简单 的 客户 代码 进行 测试 。 与 以 前 一 样 ， 这 些 代 码 应 放 在 客户 项 目的 Main0 方 法 中 ， 以 便 进行 
测试 (包含 在 本 草 下 载 代码 的 Chl11CardClient\Program.cs 文件 中 ): 


Deck deckl = new Deck(); 

Deck deck? = (Deck)deckl.Clone(t): 

WriteLine($"The first card in the original deck is: {deckl.GetCard(0)}"); 
WriteLine($"The first card in the cloned deck is: {deck2?.GetCard(0)}"); 
deck1.Shuffle(); 

WriteLine ("Original deck shuffled."); 

WriteLine ($"The first card in the original deck is: {deckl.GetCard(0)}"); 
WriteLine($"The first card in the cloned deck is: {deck2?.GetCard(0)}"); 
ReadKey (); 


其 输出 结果 如 图 11-5 所 示 。 


11.2 ”比较 


本 市 介绍 对 象 之 间 的 两 类 比较 : 
e 类 型 比较 
e 值 比较 
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类 型 比较 确定 对 象 是 什么 ， 或 者 对 象 继承 了 什么 ， 在 C# 编 程 中 ， 这 是 非常 重要 的 。 把 对 象 传递 给 方法 时 ， 
下 一 步 要 执行 什么 操作 第 取决 于 对 象 的 类 型 。 本 半 和 前 面 的 章节 部 讨 论 过 传递 对 象 的 内 容 ， 这 里 将 介绍 一 些 更 
有 用 的 技巧 。 

我 们 也 见 过 许多 “ 值 比 较 ” 至 少见 过 简单 类 型 的 值 比较 。 在 比较 对 象 的 值 时 ， 情 况 会 变 得 较为 复杂 : 必须 
从 一 开始 惑 定义 比较 的 含义 ， 确 定 像 > 这 样 的 运 鼻 符 在 比较 类 时 会 执行 什么 操作 。 这 在 集合 中 尤其 重要 ， 有 时 
我 们 布 望 根据 条 个 条 件 排列 对 象 的 顺序 ， 例 如 ， 按 照 字 母 顺序 或 者 根据 霖 个 比较 复杂 的 复 法 来 排序 。 


11.2.1 类 型 比较 


在 比较 对 象 时 ， 第 需要 了 解 它们 的 类 型 ， 才 能 确定 是 侍 可 以 进行 值 的 比较 。 第 9 章 介 绍 了 GetIype0 方 法 ， 
所 有 的 类 都 从 System.Object 中 继承 了 这 个 方法 ， 这 个 方法 和 typeof0 运 算得 一 起 使 用 ,就 可 以 确定 对 象 的 类 型 (并 
据 此 执行 操作 ): 

if (myObj.GetType() == typeof (MyComplexClass)) 


// myObj is an instance of the class MyComplexclass. 


前 面 还 提 到 ToStringOI SA 1. 3:307; 3X,  ToString() t.z& System.Object 继承 而 来 的 ， 该 方法 可 以 提供 对 象 
类 型 的 字符 串 表示 。 也 可 以 比较 这 些 字符 串 ， 但 这 是 一 种 比较 杂乱 的 比较 方式 。 

本 节 将 介绍 比较 值 的 一 种 简便 方式 ，is 运算 符 。 它 可 以 提供 可 读 性 较 高 的 代码 ， 还 可 以 检查 基 类 。 在 介绍 
is 运 复 符 之 前 ， 需 要 了 解 处 理 值 类 型 (与 引用 攻 型 相反 ) 时 后 台 的 一 些 贡 见 操作 : 封 箱 (boxing) 和 拆 箱 (anboxing)。 

1. 封 档 和 拆 箱 

第 8 划 讨 论 了 引用 类 型 和 值 类 型 之 间 的 区 别 , 第 9 半 通 过 比较 结构 ( 值 类 型 ) 和 类 (引用 类 型 ) 展 示 了 这 些 区 别 。 
封 箱 (boxing) 是 把 值 类 型 转换 为 System.Object 类 型 ， 或 者 转换 为 由 值 类 型 实现 的 接口 类 型 。 拆 箱 (anboxing) 是 相 

例如 ， 下 面 的 结构 类 型 

struct MyStruct 


public int Val; 
} 
可 以 把 这 种 类 型 的 结构 放 在 object 类 型 的 变量 中 ， 对 其 封 箱 : 
MyStruct valTypel = new MyStruct(); 


valTypel.Val = 5; 
object refType = valTypel; 


其 中 创建 了 一 个 类 型 为 MyStruct 的 新 变量 valTypel， 并 把 一 个 值 赋予 这 个 结构 的 Val 成 员 ， 然 后 把 它 封 箱 
在 object 类 型 的 变量 refType 中 。 

以 这 种 方式 封 箱 变量 而 创建 的 对 象 , 会 包含 值 类 型 变量 的 一 个 副本 的 引用 , 而 不 包含 源 值 类 型 变量 的 引用 。 
要 进行 验证 ， 可 以 修改 源 结构 的 内 容 ， 然 后 把 对 象 中 包含 的 结构 拆 箱 到 新 变量 中 ， 并 检查 其 内 容 : 

valTypel.Val = 6; 


MyStruct valType2 = (MyStruct) refType; 
WriteLine ($"valType2.Val = {valType2.Val}"); 


执行 这 段 代码 将 得 到 如 下 输出 结果 : 

valType2.Val = 5 

但 在 把 一 个 引用 类 型 赋予 对 象 时 ， 将 执行 不 同 的 操作 。 把 MyStruct 改 为 一 个 类 (不 考虑 这 个 类 名 不 合适 的 
译 况 )， 即 可 看 到 这 种 情形 : 

class MyStruct 

{ 


public int Val; 
} 
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如 全 不 修改 上 面 的 客户 代码 (再 次 忽略 名 称 有 误 的 变量 )， 融 会 得 到 如 下 输出 结果 : 

valType2.Val = 6 

也 可 以 把 值 类 型 封 箱 到 接口 类 型 中 , 只 要 它们 实现 这 个 接口 即 可 。 例 如 ,假定 MyStruct 类 型 实现 IMyInterface 
接口 ， 如 下 所 示 : 

interface IMyInterface {} 

struct MyStruct : IMyInterface 

| public int Val; 


接着 把 结构 封 箱 到 一 个 IMyInterface 类 型 中 ， 如 下 所 示 : 


MyStruct valTypel = new MyStruct(); 
IMyInterface refType = valTypel; 


2A ea 8 Hl — RC] ARGUS SA ONT EHH: 

MyStruct ValType2 = (MyStruct) refType; 

从 这 些 示例 中 可 以 看 出 ， 封 箱 是 在 没有 用 户 干 涉 的 情况 下 进行 的 ( 即 不 需要 编写 任何 代码 )， 但 拆 箱 一 个 值 
需要 进行 显 式 转换 ， 即 需要 进行 数据 类 型 转换 ( 封 箱 是 隐 式 的 ， 所 以 不 需要 进行 数据 类 型 转换 )。 

读者 可 能 想 知道 为 什么 要 这 人 么 做 。 封 箱 非常 有 用 , 有 两 个 非常 重要 的 原因 。 首 先 , 它 允 许 在 项 的 类 型 是 object 
的 集合 (如 ArrayLisb 中 使 用 值 关 型 。 其 次 ， 有 一 个 内 部 机 制 允 许 在 值 基 型 (例如 int 和 结构 ) 上 调用 object 方法 。 

最 后 需要 注音 的 是 ， 在 访问 值 类 型 内 容 前 ， 必 须 进行 拆 箱 。 

2. is AF 

is 运算 符 并 不 是 用 来 说 明 对 象 是 东 种 类 型 ， 而 十 用 来 检查 对 象 是 不 是 给 定 类 型 ， 或 者 是 否 可 以 转换 为 给 定 
类 型 ， 如 果 是 ， 这 个 运算 符 就 返回 tue. 

在 表面 的 示例 中 ， 有 Cow 和 Chicken 类 ， 它 们 部 继承 于 Animal。 使 用 is 运算 从 比较 Animal 类 型 的 对 象 ， 
如 果 对 象 是 这 3 种 类 型 中 的 一 种 (不 仅 是 Animal), is 运算 符 就 返回 true。 使 用 前 面 介绍 的 GetType0 方 法 和 typeof() 
运算 和 从 很 难 做 到 这 一 扣 。 

is 运算 符 的 语法 如 下 : 

<operand> is <type> 


这 个 表达 式 的 结果 如 下 : 

© 如 果 <mype> 是 一 个 类 类 型 ， 而 <operand> 也 是 该 类 型 ， 或 者 它 继承 了 该 类 型 ， 或 者 它 可 以 封 箱 到 该 类 型 
中 ， 则 结果 为 tme。 

。 如 果 <npe> 是 一 个 接口 类 型 ， 而 <operand> 也 是 该 类 型 ， 或 者 它 是 实现 该 接口 的 类 型 ， 则 结果 为 true. 

。 如 果 <ppe> 是 一 个 值 类 型 ， 而 <operand> 也 是 该 类 型 ， 或 者 它 可 以 拆 箱 到 该 类 型 中 ， 则 结果 为 true. 

下 面 用 一 个 示例 说 明 如 何 使 用 该 运算 符 。 


试 一 试 ” 使 用 is 运算 符 : Ch11Ex04\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapterl1 目录 中 创建 一 个 新 控制 台 应 用 程序 Ch11Ex04。 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 
namespace ChllEXx04 
| class Checker 

public void Check(object paraml) 

if (paraml is ClassA) 

WriteLine("Variable can be converted to ClassA."); 
i can't be converted to ClassA."); 


if (paraml is IMyInterface) 
WriteLine("Variable can be converted to IMyInterface."); 


$118 集合 、 比 较 和 转换 | 199 


else 
WriteLine ("Variable can't be converted to IMyInterface."); 
if (parami is MysStruct) 
WriteLine("Variable can be converted to MyStruct."); 
else 
WriteLine("Variable can't be converted to MyStruct."); 
} 
} 
interface IMyInterface {} 
class ClassA : IMyInterface {} 
class ClassB : IMyInterface {} 
class Classc {} 
class ClassD : ClassA {} 
struct MyStruct : IMyInterface {} 
[o Program 
static void Main(string[] args) 
i 
Checker check - new Checker(); 
ClassA tryl new ClassA(); 
ClassB try2 new ClassB(); 
ClassC try3 new ClassC(); 
ClassD try4 new ClassD(); 
MyStruct try5 = new MyStruct(); 
object try6 = try5; 
WriteLine ("Analyzing ClassA type variable:"); 
check .Check (try1) ; 
WriteLine("MnAnalyzing ClassB type variable:"); 
check.Check(try2); 
WriteLine("MnAnalyzing ClassC type variable:"); 
check .Check (try3) ; 
WriteLine("MnAnalyzing ClassD type variable:"); 
check .Check (try4) ; 
WriteLine("MnAnalyzing MyStruct type variable:") ; 
check .Check (try5) ; 
WriteLine ("\nAnalyzing boxed MyStruct type variable:"); 
check .Check (try6) ; 
ReadKey () ; 


} 
(3) 运行 代码 ， 其 结果 如 图 11-6 Pra. 


verted to ClassA. 
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图 11-6 
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示例 说 明 

这 个 示例 说 明了 使 用 is 运算 符 的 各 种 可 能 结果 。 其 中 定义 了 3 个 类 、 一 个 接口 和 一 个 结构 ， 并 把 它们 用 作 
一 个 类 的 方法 的 参数 ， 这 个 类 使 用 is 运 复 符 确 定 它 们 是 否 可 以 转换 为 Classa 类 型 、 接 口 类 型 和 结构 类 型 。 

只 有 ClassA 和 ClassD( 继 承 了 ClassA) 类 型 与 ClassA 兼容 。 如 果 一 个 类 型 没有 继承 一 个 类 ， 该 类 型 就 不 会 
SERRA 

ClassA. ClassB 和 MyStruct 类 型 都 实现 了 IMyInterface， 所 以 它们 都 与 IMyInterface 类 型 兼容 。ClassD 4k 
7K f ClassA, PrOVE IPA T dz. Wk, KA ClassC EARRAN]. 

最 后 ， 只 有 MyStruct 类 型 本 身 的 变量 和 该 类 型 的 封 箱 变量 与 MyStruct 兼容 ， 因 为 不 能 把 引用 类 型 转换 为 
值 类 型 (当然 ， 我 们 能 够 拆 箱 以 前 封 箱 的 变量 )。 


11.2.2 使 用 is 运算 符 模式 表达 式 进行 模式 匹配 


第 4 章 介 绍 了 switch 语句 ， 第 5 章 对 该 语句 进行 了 扩展 ， 使 其 可 以 基于 变量 类 型 (string、int 等 ) 进 行 匹 配 操 
作 。 只 要 知道 了 变量 的 类 型 ， 就 可 以 访问 其 属性 和 方法 ， 以 进一步 减少 匹配 操作 。 

由 于 is 运算 符 通常 会 实现 许多 让 ..else if... 语 句 ， 因 此 switch case 方法 是 一 种 更 优雅 的 模式 匹配 方法 。 随 着 
要 进行 模式 匹配 的 场景 增加 ， 使 用 if...else if... 语 句 会 使 代码 更 长 、 层 次 更 深 、 更 不 易 阅读 。 如 果 出 现 这 种 情况 ， 记 
住 你 还 可 以 选择 使 用 switch case 模式 匹配 。 不 过 ， 对 于 较 小 的 代码 段 ，is 运算 符 是 进行 模式 匹配 和 过 滤 数 据 集 的 一 种 
非常 有 效 且 强大 的 技术 。 例 如 ， 下 面 的 代码 : 


object[] data = 
{ 1.6180, null, new Cow("Rual"), new Chicken("Lea"), "none" }; 


foreach (var item in data) 
| if (item is 1.6180) WriteLine("The Golden Ratio"); 
else if (item is null) WriteLine("The value is null"); 
else if (item is Cow co) WriteLine($"The cow is named [co.Name]."); 
else if (item is Chicken ch) WriteLine("The chicken is named" + 
S" {ch.Name} and {ch.RunInCircles()}"); 
else if (item is var catcher) WriteLine("Catch all for" + 
5" {catcher .GetType () .Name}); 
} 
data 变量 中 的 对 象 包含 几 种 不 同 的 类 型 。 使 用 foreach 语句 迭代 object[] 数 组 时 ， 可 以 使 用 is 运算 和 从 查看 该 变量 的 
类 型 ， 当 发 现 巨 配 时 ， 就 执行 相应 的 操作 。 第 一 个 模式 匹配 发 生 在 数据 为 常量 值 1.6180 时 ， 这 是 一 个 常量 模式 示例 ， 
第 二 个 模式 匹配 中 的 gull 也 是 如 此 。 当 匹配 常量 时 ,使 用 二 = 运算 和 从 可 以 得 到 同样 的 结果 , 但 使 用 is 运算 符 更 容易 理 
data 变量 中 的 最 后 两 个 对 象 的 类 型 分 别 为 Cow 和 Chicken。 类 型 模式 在 发 现 匹 配 的 模式 时 ， 会 分 配 一 个 指定 类 型 
的 新 变量 。 例 如 ， 当 匹配 Chicken 时 ， 就 会 创建 一 个 包含 Chicken 对 象 的 新 变量 ch， 这 样 程序 员 就 可 以 访问 Chicken 
类 的 属性 和 方法 ， 例 如 ，name 属性 和 RunInCircles0 方 法 。 
最 后 ， 对 于 不 匹配 代码 路 径 中 任何 让..else 站 .语句 的 所 有 情况 ， 可 以 使 用 var 模式 。 然 后 使 用 catcher 变量 
的 GetIype().Name 属性 来 获取 变量 的 类 型 。 


11.2.3 值 比 较 


考虑 两 个 表示 人 的 Person 对 象 ， 它 们 部 有 一 个 Age 整 型 属性 。 下 面 要 比较 它们 ,看 看 哪个 人 年 龄 较 大 。 为 
此 可 以 使 用 以 下 代码 : 


if (personl.Age > person2.Age) 


} 
这 是 可 以 的 ， 但 还 有 其 他 方法 ， 例 如 ， 使 用 下 面 的 语法 : 


if (personl > person2) 
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可 以 使 用 运算 符 重 载 ， 如 本 节 后 面 所 述 。 这 是 一 项 强大 的 技术 ， 但 应 谨慎 使 用 。 在 上 面 的 代码 中 ， 年 龄 的 
比较 不 是 非 萌 明显， 该 段 代 码 还 可 以 比较 号 局 、 体 重 、IQ 等 。 

男 一 个 方法 是 使 用 IComparable 和 IComparer 接口 ， 它 们 可 采用 标准 方式 定义 比较 对 象 的 过 程 。.NET 
Framework 中 的 各 种 集合 类 支持 这 种 方式 ， 这 使 得 它们 成 为 对 集合 中 的 对 和 象 进行 排序 的 一 种 极 佳 方式 。 


1. BATS 

通过 运算 符 重 载 (operator overloading)， 可 以 对 我 们 设计 的 类 使 用 标准 的 运算 符 , 例如 +、> 等 。 这 称 为 重 载 ， 
因为 在 使 用 特定 的 参数 类 型 时 ， 我 们 为 这 些 运 算 符 提供 了 目 己 的 实现 代码 ， 其 方式 与 重 载 方法 相同 ， 也 是 为 同 
名 方法 提供 不 同 的 参数 。 

运算 符 重 载 非常 有 用 ， 因 为 我 们 可 在 运 咎 符 重 载 的 实现 中 执行 需要 的 任何 操作 ， 这 并 不 一 定 像 用 “+” 表 
示 “ 拒 这 两 个 操作 数 相 加 ”这 么 简单 。 稍 后 介绍 一 个 进一步 升级 CardLib 库 的 示例 。 我 们 将 提供 比较 运算 符 的 
实现 代码 ， 比 胃 两 张 牌 ， 看 看 在 一 圈 ( 扑 融 牌 游戏 中 的 一 局 ) 中 哪 张 牌 会 局 。 

因为 在 许多 扑克 有 牌 游 戏 中 ， 一 圈 取 决 于 牌 的 人 花色， 这 并 不 像 比较 牌 上 的 数字 那样 直接 。 如 果 第 二 张 牌 与 第 
一 张 牌 的 人 花色 不 同 ， 则 无 论 其 扣 数 是 什么 ， 第 一 张 脾 都 会 碎 。 考 虑 两 个 操作 数 的 顺序 ， 束 可 以 实现 这 种 比较 。 
也 可 以 考虑 “王牌 ”的 花色 ， 而 王牌 可 以 胜 过 其 他 花色 ， 即 使 该 王牌 的 花色 与 第 一 张 牌 不 同 ， 也 是 如 此 。 也 就 
是 说 ，cardl > card2 是 true( 这 表示 如 果 card] 是 第 一 个 出 秩 ， 则 card] 胜 过 了 card2)， 并 不 意味 痢 card2 > cardl 
是 false. WMR card] 和 card2 都 不 是 王牌 ， 且 属于 不 同 的 花色 ， 则 这 两 个 比较 都 是 true。 

BERTZE PERIERE. KERSA. ARDER RENREN E static)。 
Hee BT A PP ROS QUI - 运算 符 束 有 一 元 和 二 元 两 种 功能 )， 因 此 我 们 还 指定 了 要 处 理 多 少 个 操作 数 ， 以 及 
这 些 操作 数 的 类 型 。 一 般 情 况 下 ,操作 数 的 类 型 与 定义 运算 符 的 类 相同 , 但 也 可 以 定义 处 理 混合 类 型 的 运算 符 ， 
详 见 稍 后 的 内 容 。 

例如 ， 考 虑 一 个 简单 类 型 AddClass1， 如 下 所 示 : 

public class AddClassl 

' public int val; 

} 

xx xe int 值 的 一 个 包装 器 (wrapper)， 但 可 以 用 于 说 明 原 理 。 对 于 这 个 类 ， 下 面 的 代码 不 能 通过 编译 : 

AddClassl opl = new AddClassl(); 

opl.val = 5; 

AddClassl op2 = new AddClassl(); 

op2.val = 5; 

AddClassl op3 = opl + op2; 

其 错误 是 + 运 复 符 不 能 应 用 于 AddClassl 类 型 的 操作 数 ， 因 为 我 们 尚未 定义 要 执行 的 操作 。 下 面 的 代码 则 可 
执行 ， 但 无 法 得 到 预期 的 结果 : 

AddClassl opl = new AddClassl(); 

opl.val = 5; 

AddClassl op2 = new AddClassl(); 

op2.val = 5; 

bool op3 = opl == op2; 

其 中 , 使 用 = = 二 元 运 复 符 来 比较 op1 和 op2， 看 它们 是 售 引 用 同一 个 对 象 ， 而 不 是 验证 它们 的 值 是 人 否 相 等 。 
在 上 述 代码 中 ， 即 使 op1.val 和 op2.val 相等 ，op3 也 是 false. 

要 重 载 + 运算 全， 可 使 用 下 述 代码 : 

public class AddClassl 

l public int val; 

public static AddClassl operator +(AddClassl opl, AddClassl op2) 
| AddClassl returnVal = new AddClassl(); 


returnVal.val = opl.val + op2.val; 
return returnVal; 
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Di} 


} 
} 


HUAI, 38 EUPT SUBUEDECOK S Ee AAR, (EMEA RES operator 和 运 复 符 本 号 ， 而 不 
是 一 个 方法 名 。 现 在 可 以 成 功 地 使 用 + 运算 符 和 这 个 类 ， 如 上 面 的 示例 所 示 : 


AddClassl op3 = opl + op2; 


重 载 所 有 的 二 元 运算 符 都 是 一 样 的， 一 元 运算 符 看 起 来 也 是 类 似 的 ， 但 只 有 一 个 参数 : 


public class AddClassl 
{ 
public int val; 
public static AddClassl operator -(AddClassl opl, AddClassl op2) 
{ 
AddClassl returnVal = new AddClass1l(); 
returnVal.val = opl.val + op2.val; 
return returnVal; 
} 
public static AddClassl operator -(AddClassl op1l) 
{ 
AddClassl returnVal = new AddClassl(); 
returnVal.val = -opl.val; 
return returnVal; 
) 
} 


这 两 个 运算 和 从 处 理 的 操作 数 的 类 型 与 类 相同 ， 返 回 值 也 是 该 类 型 ， 但 考虑 下 面 的 类 定义 : 


public class AddClassl 
{ 
public int val; 
public static AddClass3 operator +(AddClassl opl, AddClass2 op2) 
{ 
AddClass3 returnVal = new AddClass3(); 
returnVal.val = opl.val + op2.val; 
return returnVal; 


} 


} 
public class AddClass2 
{ 

public int val; 
} 
public class AddClass3 
{ 

public int val; 
} 

Z —— ee ee 

Fri gf s n] AAT: 
AddClassl opl = new AddClass1(); 
opl.val = 5; 
AddClass2 op2 = new AddClass2(); 
op2.val = 5; 
AddClass3 op3 = opl + op2; 


可 以 酌情 采用 这 种 方式 混合 类 型 。 但 要 注意， 如 果 把 相同 的 运算 符 添 加 到 AddClass2 PF, Em fd 
失败 ， 因 为 它 弄 不 清 要 使 用 哪个 运算 得 。 因 此 ， 应 注音 不 要 把 签名 相同 的 运算 从 添加 a 到 多 个 类 中 。 

还 要 注意 ， 如 果 混 合 了 类 型 ， 操 作 数 的 顺序 必须 与 运算 符 重 载 的 参数 顺序 相同 。 如 果 使 用 了 重 载 的 运算 符 
和 顺序 错误 的 操作 数 ， 操 作 束 会 失败 。 所 以 不 能 像 下 面 这 样 使 用 运算 符 : 


AddClass3 op3 = op2 + opl; 
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public static AddClass3 operator +(AddClass2 opl, AddClassl op2) 
{ 
AddClass3 returnVal = new AddClass3(); 
returnVal.val = opl.val + op2.val; 
return returnVal; 
} 
可 以 草 载 下 述 运算 付 : 
e —JLi fj: +,-,!~+H,-- true, false 
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注意 : 


如 果 重 载 tue 和 false 运算 符 ， 就 可 以 在 布尔 表达 式 中 使 用 类 ， 例 如 ，if(op1) f. 


不 能 重 载 赋值 运算 得 ， 例 如 +=， 但 这 些 运 算 符 使 用 与 它们 对 应 的 简单 运算 符 ， 例 如 +， 所 以 不 必 担 心 它们 。 
里 载 + 意味 看 += 如 期 执行 。= 运 算 香 不 能 午 载 ， 因 为 它 有 一 个 基本 用 途 。 但 这 个 运算 符 与 用 尸 定 义 的 转换 运算 符 
相关 ， 详 见 下 一 节 。 
也 不 能 重 载 && 和 |， 但 它们 使 用 对 应 的 运算 得 & 和 | 执行 计算 ， 所 以 重 载 & 和 | WE I 
一 些 运 得 符 ( 如 < 和 >) 必 须 成 对 重 载 。 这 束 是 说 ， 如 果 重 载 >， 就 必须 也 重 载 <。 许 多 情况 下 ， 可 以 在 这 些 
运算 符 中 调用 其 他 运 复 符 ， 以 减少 需要 的 代码 数量 (和 可 能 发 生 的 错误 )， 例 如 : 
public class AddClassl 
{ 
public int val; 
public static bool operator »-(AddClassl opl, AddClassl op2) 
=> (opl.val >= op2.val); 
public static bool operator «(AddClassl opl, AddClassl op2) 
=> '(opl >= op2); 
// Also need implementations for <= and > operators. 
} 


在 较 复 杂 的 运算 符 定义 中 ,这 可 以 减少 代码 行 数 。 这 也 意味 着 ,如 果 后 来 决定 修改 这 些 运算 符 的 实现 代码 ， 
需要 改动 的 代码 将 较 少 。 

这 同样 适用 于 = = 和 !=， 但 对 于 这 些 运 算 件 ， 通 第 需 要 重 写 Object.Equals()#! Object.GetHashCode(). [Al 
为 这 两 个 函数 也 可 以 用 于 比较 对 象 。 童 写 这 些 方法 ， 可 以 确保 无 论 类 的 用 户 使 用 什么 技术 ， 部 能 得 到 相同 的 结 
果 。 这 不 太 重要 ， 但 应 增加 进来 ， 以 保证 其 完整 性 。 它 需要 下 述 非 静态 重 写 方法 : 


public class AddClassl 
{ 
public int val; 
public static bool operator ==(AddClassl opl, AddClass1 op2) 
=> (opl.val == op2.val); 
public static bool operator !=(AddClassl opl, AddClassl op2) 
=> ! (opl = op2); 
public override bool Equals (object opl) => val == ((AddClassl)opl).val; 
public override int GetHashCode() => val; 
} 


GetHashCode0O 可 根据 其 状态 ， 获 取 对 象 实例 的 一 个 唯一 int 值 。 这 里 使 用 val 束 可 以 了 ， 因 为 它 也 是 一 
个 int 值 。 

注意 ，Equals0 使 用 object 类 型 参数 。 我 们 需要 使 用 这 个 签名 ， 否 则 就 将 重 载 这 个 方法 ， 而 不 是 重 写 它 。 类 
的 用 户 仍 可 以 访问 默认 的 实现 代码 。 这 样 承 必须 使 用 数据 其 型 转换 得 到 所 需 的 结果 。 这 和 需要 使 用 本 章 前 面 讨 
论 的 is 运算 符 检查 对 象 类 型 ， 代 码 如 下 所 示 ; 


public override bool Equals(object opl) 
{ 
if (opl is AddClassl) 
{ 
return val == ((AddClassl)opl).val; 
} 
else 
{ 
throw new ArgumentException( 
"Cannot compare AddClassl objects with objects of type " 
+ opl.GetType().ToString()):; 
} 
} 


在 这 段 代 码 中 ， 如 果 传 递 给 Equals 的 操作 数 的 类 型 有 误 ， 或 者 不 能 转换 为 正确 类 型 ， 束 会 抛 出 一 个 异 利 。 
当然 ， 这 可 能 并 不 是 我 们 希望 的 操作 。 我 们 要 比较 一 个 类 型 的 对 象 和 男 一 个 类 型 的 对 象 ， 此 时 需要 更 多 的 分 文 
结构 。 另 外 ， 可 能 只 允许 对 类 型 完全 相同 的 两 个 对 象 进行 比较 ， 这 需要 对 第 一 个 让 语句 做 如 下 修改 : 
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if (opl.GetType() == typeof (AddClass1) ) 
2. 给 CardLib 添加 运算 符 重 载 
现在 再次 升级 Ch11CardLib 项 目 , 给 Card 类 添加 运 咎 符 重 载 。 在 本 章 下 载 代码 的 Chl1CardLib 文件 夹 中 可 
以 找到 以 下 的 类 的 代码 。 首 先 给 Card 类 添加 额外 字段 ， 人 允许 使 用 “王牌 ”花色 ， 使 A 有 更 高 的 级 别 。 把 这 些 
字段 指定 为 静态 ， 因 为 设置 它们 后 ， 它 们 就 可 以 应 用 到 所 有 Card 对 象 上 : 


{ 


public class Card 


/// <summary> 

/// Flag for trump usage. If true, trumps are valued higher 
/// than cards of other suits. 

/// </summary> 

public static bool useTrumps = false; 

/// <summary> 

/// Trump suit to use if useTrumps is true. 

/// </summary> 

public static Suit trump - Suit.Club; 

/// <summary> 

/// Flag that determines whether aces are higher than kings or lower 
/// than deuces. 

/// </summary> 

public static bool isAceHigh - true; 


这 些 规则 应 用 于 应 用 程序 中 每 个 Deck 的 所 有 Card 对 象 上 。 因 此 ， 两 个 Deck 中 的 Card 不 可 能 遵守 不 同 规 
则 。 这 适用 于 这 个 类 库 ， 但 是 确实 可 以 做 出 这 样 的 假设 : 如 果 一 个 应 用 程序 要 使 用 不 同 的 规则 ， 可 以 日 行 维护 
这 些 规 则 ， 例 如 ， 在 切换 牌 时 ， 设 置 Card 的 静态 成 员 。 

完成 后 ， 就 要 给 Deck 类 再 添加 几 个 构造 函数 ， 以 便 用 不 同 的 特性 来 初始 化 扑克 有 牌 : 


/// <summary> 
/// Nondefault constructor. Allows aces to be set high. 
/// </summary> 
public Deck (bool isAceHigh) : this () 
{ 
Card.isAceHigh = isAceHigh; 
} 
/// <summary> 
/// Nondefault constructor. Allows a trump suit to be used. 
/// </summary> 
public Deck (bool useTrumps, Suit trump) : this () 
{ 
Card.useTrumps = useTrumps; 
Card.trump = trump; 


/// <summary> 

/// Nondefault constructor. Allows aces to be set high and a trump suit 
/// to be used. 

/// </summary> 

public Deck(bool isAceHigh, bool useTrumps, Suit trump) : this() 


{ 
Card.isAceHigh = isAceHigh; 
Card.useTrumps - useTrumps; 
Card.trump — trump; 

) 


每 个 构造 函数 都 使 用 第 9 草 介 绍 的 : this0 语 法 来 定义 ， 这 样 ， 无 论 如 何 ， 默 认 构 造 函数 总 会 在 非 默 认 的 构 
造 隙 数 之 前 被 调用 ， 以 初 妈 化 扑克 有 牌 。 


注意 : 

第 12 章 将 详细 讨论 = = 和 > 运算 符 重 载 方法 中 实现 的 空 条 件 运 算 符 (?.)。 在 这 个 代码 段 中 ，public static bool 
operator = = 方法 的 card1?.suit 在 试图 检索 suit 存储 的 值 之 前 , 检查 cardl PRAGA. 在 后 续 章节 中 实现 方法 
时 ， 这 是 很 重要 的 。 


BOB, 56 Card 类 添加 运算 符 重 载 (和 推荐 的 重 写 代 但 ): 


public static bool operator ——(Card cardl, Card card2) 
=> (cardi?.suit == card2?.suit) && (cardl?.rank == card2?.rank); 
public static bool operator !=(Card cardl, Card card?) 
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=> !(cardl == card2); 
public override bool Equals(object card) => this == (Card)card; 
public override int GetHashCode () 
=> 13 * (int)suit + (int)rank; 
public static bool operator >(Card cardl, Card card?) 


{ 
if (cardl.suit == card2.suit) 
{ 
if (isAceHigh) 
{ 
if (cardl.rank == Rank.Ace) 
{ 
if (card2.rank == Rank.Ace) 
return false; 
else 
return true; 
} 
else 
{ 
if (card?.rank == Rank.Ace) 
return false; 
else 
return (cardl.rank > card2?.rank) ; 
} 
} 
else 
{ 
return (cardl.rank > card2.rank); 
} 
else 
{ 
if (useTrumps && (card2.suit == Card.trump) ) 
return false; 
else 
return true; 
) 
} 


public static bool operator «(Card cardl, Card card?) 
=> '(cardl >= card2); 
public static bool operator >=(Card cardl, Card card2) 


{ 
if (cardl.suit == card2.suit) 
{ 
if (isAceHigh) 
{ 
if (cardl.rank == Rank.Ace) 
{ 
return true; 
} 
else 
{ 
if (card2.rank == Rank.Ace) 
return false; 
else 
return (cardl.rank >= card2.rank); 
) 
else 
{ 
return (cardl.rank >= card2.rank); 
} 
else 
{ 
if (useTrumps && (card2.suit == Card.trump) ) 
return false; 
else 
return true; 
} 
} 


public static bool operator <=(Card cardl, Card card2) 
=> '(cardl > card2); 


这 段 代 码 没 什么 需要 特别 关注 之 处 ， 只 是 > 和 关 重 载运 算 符 的 代码 比较 长 。 如 果 单 步 执 行 > 运 鼻 符 的 代码 ， 
束 可 以 看 到 它 的 执行 情况 ， 并 且 明 日 为 什么 需要 这 些 步骤。 
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比较 两 张 牌 cardl 和 card2， 其 中 card] 假定 为 先 出 的 牌 。 如 前 所 述 ， 在 使 用 王牌 时 ， 这 是 很 重要 的 ， 因 为 
王牌 胜 过 其 他 牌 ， 即 使 非 王 牌 比 较 大 ， 也 是 这 样 。 当 然 ， 如 果 两 张 牌 的 化 色相 同 ， 则 王 和 由 是否 也 是 该 伦 色 束 不 
重要 了 ， 所 以 这 是 我 们 要 进行 的 第 一 个 比较 : 

public static bool operator >(Card cardl, Card card2) 
| if (cardl.suit == card2.suit) 


{ 
URBIS isAceHigh 标记 为 true， 融 不 能 直接 通过 Rank 枚 举 中 的 值 比较 牌 的 点 数 了 。 因 为 A 的 点 数 在 这 
个 枚 举 中 是 1， 比 其 他 牌 痢 小 。 此 时 惑 再 要 如 下 步 又 : 
e 如 果 第 一 张 牌 是 A， 就 检查 第 二 张 牌 是 否 也 是 A。 如 果 是 ， 则 第 一 张 牌 就 胜 不 过 第 二 张 牌 。 如 果 第 二 张 
牌 不 是 A， 则 第 一 张 牌 胜出 : 
if (isAceHigh) 
l if (cardl.rank == Rank.Ace) 
i if (card2.rank == Rank.Ace) 
return false; 


else 
return true; 


} 
e 如 果 第 一 张 牌 不 是 A， 也 再 要 检查 第 二 张 牌 是 不 是 A。 如 果 是 ， 则 第 二 张 牌 胜出 ; 否则 ， 融 可 以 比较 牌 
的 点 数 ， 因 为 此 时 已 不 比较 A T: 
else 
i 1f (card2.rank == Rank.Ace) 
return false; 
else 
return (cardl.rank > card??.rank); 
} 
} 
e 万 外 ， 如 果 A 不 是 最 大 的 ， 束 只 需要 比较 和 的 点 数 : 
else 
{ 


return (cardl.rank > card2.rank); 


代码 的 其 余部 分 主要 考虑 card] 和 card2 花色 不 同 的 情况 。 其 中 静态 useTrumps 标记 是 非常 重要 的 。 如 果 
这 个 标记 是 true, H card2 是 王牌 ， 则 可 以 肯定 ，cardl 不 是 王牌 (因为 这 两 张 牌 有 不 同 的 花色 )， 王 牌 总 是 胜出 ， 
所 以 card2 比较 大 : 


else 
{ 
if (useTrumps && (card2.suit == Card.trump)) 
return false; 


如 果 card2 不 是 王牌 (或 者 useTrumps 是 false), MW) card] 胜出 ， 因 为 它 是 最 先 出 的 牌 : 


else 
return true; 
} 
} 


刀 有 一 个 运 复 符 (=) 使 用 与 此 类 似 的 代码 ， 除 此 之 外 的 其 他 运算 符 都 非常 简单 ， 所 以 不 需要 详细 分 析 它 们 。 
下 面 的 简单 客户 代码 测试 这 些 运 算 符 。 把 它 放 在 客户 项 目的 Main0 方 法 中 进行 测试 ， 束 像 前 和 面 CardLib 
示例 的 客户 代码 那样 (这 段 代 码 包含 在 Ch11CardClient\Program.cs 文件 中 ): 


Card.isAceHigh = true; 

WriteLine("Aces are high."); 
Card.useTrumps = true; 

Card.trump = Suit.Club; 

WriteLine ("Clubs are trumps."); 

Card cardl, card2, card3, card4, card5; 
card] = new Card(Suit.Club, Rank.Five); 
card2 = new Card(Suit.Club, Rank.Five); 
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card3 = new Card(Suit.Club, Rank.Ace); 
card4 = new Card(Suit.Heart, Rank.Ten); 
card5 = new Card(Suit.Diamond, Rank.Ace); 
WriteLine($"[cardl.ToString()) == {card2.ToString()} ? {cardl == card2}"); 
WriteLine ($"{card1.ToString()} != {card3.ToString()} ? {cardl != card3}"); 
WriteLine($"[cardl.ToString()].Equals((card4.ToString()]) ? " + 
5" { cardl.Equals (card4) ]"); 
WriteLine ($"Card.Equals({card3.ToString()}, {card4.ToString()}) ? " + 
5" { Card.Equals(card3, card4)}"); 
WriteLine($"[cardl.ToString()) > {card2.ToString()} ? {cardl > card2}"); 
WriteLine($"[cardl.ToString()) <= {card3.ToString()} ? {cardl <= card3}"); 
WriteLine ($"{card1.ToString()} > {card4.ToString()} ? {cardl > card4}"); 
WriteLine ($"{card4.ToString() } (cardl.ToString()) ? {card4 > cardl)"); 
? {card5 > card4}"); 
? {card4 > card5}"); 


> 
WriteLine ($"{card5.ToString()} > {card4.ToString() } 
> [card5.ToString()] 


WriteLine ($"{card4.ToString () } 
ReadKey (); 


其 结果 如 图 11-7 所 示 。 


这 两 种 情况 下 ， 在 应 用 运算 符 时 都 考虑 了 指定 的 规则 。 这 在 输出 结果 的 最 后 4 行 中 尤其 明显 ， 说 明王 牌 总 
是 胜 过 其 他 牌 。 


3. IComparable #1 IComparer 接口 


IComparable 和 IComparer 接口 是 NET Framework "P HERI RIN pate TTT. 3X PAP RE ZA KG F : 

e Comparable 在 要 比较 的 对 象 的 类 中 实现 ， 可 以 比较 该 对 象 和 夯 一 个 对 象 。 

e IComparer 在 一 个 单独 的 类 中 实现 ， 可 以 比较 任意 两 个 对 象 。 

一 般 使 用 IComparable 给 出 类 的 默认 比较 代码 ， 使 用 其 他 类 给 出 非 默 认 的 比较 代码 。 

IComparable 提供 了 一 个 方法 CompareTo0， 这 个 方法 接受 一 个 对 象 。 例 如 ， 在 实现 该 方法 时 ， 使 其 可 以 接 
受 一 个 Person 对 象 ， 以 便 确 定 这 个 人 比 当 前 的 人 更 年 老 还 是 更 年 轻 。 实 际 上 ， 这 个 方法 返回 一 个 int， 所 以 也 
可 以 确定 第 二 个 人 与 当前 的 人 的 年 龄 差 : 

if (personl.CompareTo(person2) == 0) 


{ 


WriteLine ("Same age"); 


else if (personl.CompareTo(person2) > 0) 


{ 

WriteLine ("person 1 is Older"); 
} 
else 
{ 

WriteLine("personl is Younger"); 
} 


IComparer 也 提供 一 个 方法 Compare0。 这 个 方法 接受 两 个 对 象 ， 返 回 一 个 整 型 结果 ,这 与 CompareTo0 相 同 。 
对 于 文 持 IComparer 的 对 象 ， 可 使 用 下 面 的 代码 : 
if (personComparer.Compare(personl, person2) == 0) 


WriteLine ("Same age"); 


} 


else if (personComparer.Compare(personl, person2) > 0) 
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Di} 


WriteLine ("person 1 is Older"); 
} 


else 


WriteLine("personl is Younger"); 


这 两 种 情况 下 ， 提 供给 方法 的 参数 是 System.Object KH., KSA UHER — 156] $5 Et EE 2H] A 
AHR. PTO, FRE, XOU BET HMA, WEA T RRN, XS mmm. 
NET Framework 在 类 Comparer 上 提供 了 IComparer 接口 的 默认 实现 代码 ， 类 Comparer 位 于 System.Collections 
名 称 空间 中 ， 可 以 对 简单 类 型 以 及 支持 IComparable 接口 的 任意 类 型 进行 特定 文化 的 比较 。 例 如 ， 可 通过 下 面 
的 代码 使 用 它 : 
string firstString = "First String"; 
string secondString = "Second String"; 
WriteLine($"Comparing '{firstString}' and '{secondString}', " + 
S5"result: {Comparer.Default.Compare(firstString, secondString) }"); 
int firstNumber = 35; 
int secondNumber = 23; 
WriteLine ($"Comparing '{firstNumber}' and '{ secondNumber }', " + 
e"result: {Comparer.Default.Compare(firstNumber, secondNumber) }"); 


这 里 使 用 Comparer.Default 静态 成 员 获 取 Comparer 类 的 一 个 实例 ， 接 独 使 用 Compare0 方 法 比较 前 两 个 字 
符 串 ， 之 后 比较 两 个 整数 ， 结 果 如 下 : 


Comparing 'First String' and 'Second String", result: -1 
Comparing '35' and '23', result: 1 


在 字母 表 中 , FES 的 前 面 ， 所 以 F“ 小 于 ”S， 第 一 个 比较 的 结果 了 就 是 - 1。 同 样 ，35 大 于 23， 所 以 结果 
是 1。 注 意 这 里 的 结果 并 未 给 出 相差 的 幅度 。 

在 使 用 Comparer 时 ， 必 须 使 用 可 以 比较 的 类 型 。 例如, 试图 比较 firstString 和 firstNumber 就 会 生成 一 个 
m. 
下 面 列 出 了 有 关 这 个 类 的 一 些 注意 事项 : 

e WAR ComparerCompareO 的 对 象 ， 看 看 它们 是 否 文 持 IComparable。 如 果 文 持 ， 束 使 用 该 实现 
代码 。 

o 人 允许 使 用 null 值 ， 它 被 解释 为 “小 于 ”其 他 任意 对 象 。 

e 字符 串 根 据 当前 文化 来 处 理 。 要 根据 不 同 的 文化 (或 语言 ) 处 理 字 符 串 ，Comparer 类 必须 使 用 其 构造 函数 进 
行 实例 化 ， 以 便 传 送 用 于 指定 所 使 用 的 文化 的 System.Globalization.CultureInfo 对 象 。 

e 字符 串 在 处 理 时 要 区 分 大 小 写 。 如 果 要 以 不 区 分 大 小 写 的 方式 来 处 理 它 们 ， 吏 需要 使 用 
CaseInsensitiveComparer 类 ， 该 类 以 相同 的 方式 工作 。 

4. 对 集合 排 厅 

许多 集合 类 可 以 用 对 象 的 默认 比较 方式 进行 排序 ， 或 者 用 定制 方法 来 排序 。ArrayList 就 是 一 个 示例 ， 它 包 

含 方法 Sort0， 这 个 方法 使 用 时 可 以 不 市 参数 ， 此 时 使 用 默认 的 比较 方式 ， 也 可 以 给 它 传递 IComparer 接口 ， 以 

比较 对 象 对 。 

给 ArrayList 填充 了 简单 类 型 时 ， 例 如 整数 或 字符 串 ， 就 会 进行 默认 的 比较 。 对 于 目 己 的 类 ， 必 须 在 类 定义 中 实 
现 IComparable， 或 创建 一 个 文 持 IComparer 的 类 ， 来 进行 比较 。 

注意 ，System.Collections 名 称 空间 中 的 一 些 类 (包括 CollectionBase) 都 没有 提供 排 友 方法。 如果 要 对 派生 于 
这 个 类 的 集合 排序 ， 就 必须 多 做 一 些 工作 ， 目 己 给 内 部 的 List 集合 排序 。 

下 面 的 示例 说 明 如 何 使 用 默认 的 和 非 默认 的 比较 方式 给 列表 排序 。 


试 一 试 ”给 列表 排 夺 : Ch11Ex05 


(1) 在 C:\BeginningCSharp7\Chapterll 目录 中 创建 一 个 新 控制 台 应 用 程序 Chl1Ex05。 
(2) 添加 一 个 新 类 Person， 修 改 Person.cs 中 的 代码 ， 如 下 所 示 : 


#112 


namespace ChllEx05 

{ 
public class Person : IComparable 
{ 

public string Name; 
public int Age; 
public Person(string name, int age) 
{ 
Name = name; 
Age = age; 
} 
public int CompareTo(object obj) 
{ 

if (obj is Person) 

{ 
Person otherPerson = obj as Person; 
return this.Age - otherPerson.Age; 

} 

else 

{ 
throw new ArgumentException ( 

"Object to compare to is not a Person object."); 


} 
(3) 添加 一 个 新 类 PersonComparerName， 修 改 代码 ， 如 下 所 示 : 


using System; 

using System.Collections; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

using System. Threading.Tasks; 
namespace ChllEx05 


{ 
public class PersonComparerName : IComparer 
{ 
public static IComparer Default = new PersonComparerName () ; 
public int Compare (object x, object y) 
{ 
if (x is Person && y is Person) 
{ 
return Comparer .Default.Compare ( 
((Person)x).Name, ((Person)y).Name); 
} 
else 
{ 
throw new ArgumentException ( 
"One or both objects to compare are not Person objects."); 
} 
} 
] 
} 


(4) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using System; 

using System.Collections; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System. Threading.Tasks; 
using static System.Console; 
namespace ChllEx05 


{ 
class Program 
i 
static void Main(string[] args) 
{ 


ArrayList list = new ArrayList () ; 
list.Add(new Person("Rual", 30)); 
list.Add(new Person("Donna", 25)); 
list.Add(new Person("Mary", 27)); 
list.Add(new Person("Ben", 44)); 
WriteLine("Unsorted people:"); 

for (int i = 0; i < list.Count; i++) 
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{ 
WriteLine ($"{(list[i] as Person) .Name } ({(list[i] as Person) .Age })"); 
} 
WriteLine (); 
WriteLine ( 
"People sorted with default comparer (by age):"); 
list.Sort(); 
for (int i = 0; i < list.Count; i++) 
{ 
WriteLine ($"{(list[i] as Person) .Name } ({(list[i] as Person) .Age })"); 
} 
WriteLine(); 
WriteLine ( 
"People sorted with nondefault comparer (by name):"); 
list.Sort (PersonComparerName .Default) ; 
for (int i = 0; i < list.Count; i++) 
{ 
WriteLine ($"{(list[i] as Person) .Name } (((list[i] as Person) .Age })"); 
} 
ReadKey () ; 


] 
} 


(5) 执行 代码 ， 结 果 如 图 11-8 所 示 。 


图 11-8 


示例 说 明 
在 这 个 示例 中 ， 包 含 Person 对 象 的 ArrayList 用 两 种 不 同 的 方式 排序 。 调 用 不 市 参数 的 ArrayList.Sort0 方 法 ， 将 
使 用 默认 的 比较 方式 ， 也 就 是 使 用 Person 类 中 的 CompareTo0 方 法 (因为 这 个 类 实现 了 IComparable): 


public int CompareTo(object obj) 


{ 
if (obj is Person) 
{ 
Person otherPerson = obj as Person; 
return this.Age — otherPerson.Age; 
} 
else 
{ 
throw new ArgumentException ( 
"Object to compare to is not a Person object."); 
] 
} 


这 个 方法 首先 检查 其 参数 能 否 与 Person 对 象 进行 比较 ， 即 该 对 象 能 否 转换 为 Person 对 象 。 如 果 遇 到 问题 ， 
就 抛 出 一 个 异 弟 。 奋 则 ， 束 比较 两 个 Person 对 象 的 Age 属性 。 

接着 ,使 用 实现 了 IComparer 的 PersonComparerName 类 ,执行 非 默认 的 比较 排序 。 这 个 类 有 一 个 公共 的 表 
态 字段 ， 以 方便 使 用 : 


public static IComparer Default = new PersonComparerName (); 
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它 可 以 用 PersonComparerName.Default 获取 一 个 实例 ,就 像 前 面 的 Comparer 类 一 样 。 这 个 类 的 CompareTo() 
方法 如 下 : 


public int Compare(object x, object y) 
{ 


if (X is Person && y is Person) 
{ 
return Comparer.Default.Compare ( 
((Person)x).Name, ((Person)y).Name); 


} 
else 
{ 
throw new ArgumentException ( 
"One or both objects to compare are not Person objects."); 
} 
} 


这 里 也 是 首先 检查 参数 ， 看 看 它们 是 不 是 Person HR, WR E Eu — dor: 如 条 是 ， 就 用 默认 的 
Comparer 对 象 比 较 Person 对 象 的 两 个 字符 串 字 段 Name. 


11.3 ”转换 


到 目前 为 止 ， 在 需要 把 一 种 类 型 转换 为 另 一 种 类 型 时 ， 使 用 的 都 是 类 型 转换 。 但 这 并 非 是 唯一 方式 。 在 计 
算 过 程 中 ，int 可 隐 式 转换 为 long 或 double， 采 用 相同 的 方式 还 可 以 定义 所 创建 的 类 ( 隐 式 或 显 式 ) 转 换 为 其 他 类 
的 方式 。 为 此 ， 可 重 载 转换 运算 符 ， 其 方式 与 本 章 前 面 重 载 其 他 运算 符 的 方式 相同 。 本 节 第 一 部 分 就 介绍 重 载 
方式 。 本 节 还 将 介绍 另 一 个 有 用 的 运算 符 : as 运算 符 ， 它 一 般 适 用 于 引用 类 型 的 转换 。 


113.1 重 载 转换 运算 符 


除了 重 载 上 述 数 学 运算 从 外 ， 还 可 以 定义 类 型 之 间 的 隐 式 和 显 式 转换 。 如 果 要 在 不 相关 的 类 型 之 间 转 换 ， 
例如 类 型 之 轩 没 有 继承 关系 ， 也 没有 共享 接口 ， 就 必须 这 么 做 。 
下 面 定 义 ConvClassl 和 ConvClass2 AJM baste, Bst; FA: 


ConvClassl opl = new ConvClass1(); 
ConvClass2 op2 = opl; 


男 外 ， 可 以 定义 一 个 显 式 转换 : 


ConvClassl opl 
ConvClass2 op2 


public class ConvClassl 
{ 
public int val; 
public static implicit operator ConvClass2(ConvClassl opl) 


new ConvClassl(); 
(ConvClass2)opl; 


ConvClass2 returnVal = new ConvClass2(); 
returnVal.val = opl.val; 
return returnVal; 


} 


} 
public class ConvClass2 
{ 
public double val; 
public static explicit operator ConvClassl(ConvClass2 opl) 


{ 
ConvClassl returnVal = new ConvClassl (); 
checked {returnVal.val = (int)opl.val;}; 
return returnVal: 

} 


} 
其 中 ，ConvClassl 包 舍 一 个 int 值 ，ConvClass2 包含 一 个 double 值 。int 值 可 以 隐 式 转换 为 double 值 ， 所 以 可 在 
ConvClassl 和 ConvClass2 之 间 定 义 一 个 隐 式 转换 。 但 反 过 来 就 不 可 行 ， 应 把 ConvClass2 和 ConvClassl 之 间 的 转 
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在 代码 中 ， 用 关键 字 implicit 和 explicit 来 指定 这 些 转换 ， 如 上 所 示 。 对 于 这 些 类 ， 下 面 的 代码 就 很 好 : 
ConvClassl opl = new ConvClassl(); 


opl.val = 3; 
ConvClass2 op2 = opl; 


但 反 同 转换 需要 进行 下 述 显 式 数 据 类 型 转换 : 
ConvClass2 opl = new ConvClass2(); 


opl.val = 3e15; 
ConvClassl op2 = (ConvClassl)opl: 


如 果 在 显 式 转换 中 使 用 了 checked 关键 字 ， 则 上 述 代 码 将 产生 一 个 异 第 ， 因 为 opl 的 val 属性 值 太 大 ， 不 能 
放 在 op2 的 val 属性 中 。 


11.32 as 运算 符 
as 运算 符 使 用 下 面 的 语法 ， 把 一 种 类 型 转换 为 指定 的 引用 类 型 ; 


«operand» as «type» 


这 只 适用 于 下 列 情况 : 

@ <operand> 的 类 型 是 <type> 

e <operand> 可 以 隐 式 转换 为 <pype> 类 型 

e -operand»u] VAS 18 El<type> rn 

如 果 不 能 从 <operand= 转 换 为 <type=， 则 表达 式 的 结果 就 是 null. 

基 类 到 派生 类 的 转换 可 以 使 用 显 式 转换 来 进行 , 但 这 并 不 忌 是 有 效 的 。 考 虑 前 和 面 示例 中 的 两 个 类 ClassA 和 
ClassD， 其 中 ClassD 继承 了 ClassA: 


Class ClassA : IMyInterface {} 
class ClassD : ClassA (] 


下 面 的 代码 使 用 as 运算 符 把 obj] 中 存储 的 Classa 实例 转换 为 ClassD 2378: 


ClassA objl 
ClassD obj2 


new ClassA(); 
obj1 as ClassD; 


则 obj2 的 结果 为 null。 

还 可 以 使 用 多 态 性 把 ClassD 实例 存储 在 Classa 类 型 的 变量 中 。 下 面 的 代码 演示 了 这 一 后 ，ClassA 类 型 
的 变量 包含 ClassD 类 型 的 实例 ， 使 用 as 运算 符 把 Classa 类 型 的 变量 转换 为 ClassD 类 型 。 

ClassD objl 


ClassA obj2 
ClassD obj3 


new ClassD(); 

obj1; 

obj2 as ClassD; 

这 次 obj3 最 后 包含 与 objl 相同 的 对 象 引 用 ， 而 不 是 null。 

因此 ，as 运算 符 非 党 有 用 ， 下 面 使 用 简单 类 型 转换 的 代码 会 殷 出 一 个 异 弟 : 


ClassA objl 
ClassD obj2 


new ClassA(); 
(ClassD) obj1; 


与 此 代码 等 价 的 as 代码 会 把 null 值 赋予 obj2， 不 会 抛 出 异 利 。 这 表示 ， 下 面 的 代码 (使 用 本 章 前 面 开 发 的 
两 个 类 : Animal 和 派生 于 Animal 的 一 个 类 Cow)££ C# 应 用 程序 中 是 很 常见 的 : 


public void MilkCow(Animal myAnimal) 
{ 
Cow myCow = myAnimal as Cow; 
if (myCow != null) 
{ 
myCow.Milk(); 
} 
else 
{ 
WriteLine (S"{myAnimal.Name} isn't a cow, and so can't be milked."); 
} 
} 
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这 要 比 检查 异常 简单 得 多 ， 
11.4 “习题 


(D) 创建 一 个 集合 类 People ， 它 是 下 述 Person 关 的 一 个 集合 ， 该 集合 中 的 项 可 以 通过 一 个 字符 串 索 引 符 来 
访问 ， 该 字符 串 索 引 符 是 人 名 ， 与 Person.Name 属性 相同 : 


public class Person 
{ 
private string name; 
private int age; 
public string Name 
{ 
get { return name; } 
set { name = value; } 


} 
public int Age 
{ 
get { return age; } 
set { age = value; } 
} 
} 


(2) 扩展 上 一 题 中 的 Person 8, ER>, <, >All FF, Lb Person 实例 的 Age 属性 。 

(3) 给 People 类 添加 GetOldest0 方 法 ， 使 用 习题 (2) 中 定义 的 重 载 运算 伯 ， 返 回 其 Age 属性 值 为 最 大 值 的 
Person 对 象 数组 (1 个 或 多 个 对 象 ， 因 为 对 于 这 个 属性 而 言 ， 多 个 项 可 以 有 相同 的 值 )。 

(4) 在 People 类 上 实现 ICloneable 接口 ， 提 供 深 上 度 复制 功能 。 

(5) 给 People 类 添加 一 个 迭代 器 ， 通 过 下 面 的 foreach 循环 获取 所 有 成 员 的 年 龄 : 

foreach (int age in myPeople.Ages) 


// Display ages. 
} 


附录 A 给 出 了 习题 答案 。 
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主 a 要 gm 
集合 是 可 以 包含 其 他 类 的 实例 的 类 。 要 定义 集合 ， 可 从 CollectionBase 中 派生 ， 或 者 自己 实现 集合 接口 ， 例 如 


AUR | Tbaamerable、ICollection 和 IList。_ 般 需要 为 集合 定义 一 个 索引 符 ， 以 使 用 collection[index] 语 法 来 访问 集合 成 员 
mn 也 可 以 定义 键 控 集合 ， 即 字典 ， 字 典 中 的 每 一 项 都 有 一 个 关联 的 键 。 在 字典 中 ， 键 可 以 用 于 标识 一 项 ， 而 不 必 使 


用 该 项 的 夫 引 。 可 以 通过 实现 IDictionary， 或 者 从 DictionaryBase 派生 类 的 方式 来 定义 字典 

可 以 实现 一 个 迭代 器 ， 来 控制 循环 代码 如 何在 其 循环 过 程 中 获取 值 。 要 和 代 一 个 类 ， 需 要 实现 GetEnumerator0 方 
Bae ik, FORA numerator. BARA A, PIT, AEH Enumerable 返回 类 型 。 在 迭代 器 的 代码 块 

H, {H yield 关键 宇 返回 值 

可 使 用 GetType0 方 法 获得 对 象 的 类 型 ， 使 用 typeoft0 运 算 符 可 以 获得 类 的 类 型 。 可 以 比较 这 些 类 型 值 。 还 可 以 使 


类 型 比 
人 | 用 到 运算 符 确定 对 象 是 否 与 某 个 类 类 型 兼容 
如 果 希 望 类 的 实例 可 以 用 标准 的 C# 运 算 符 进行 比较 , 就 必须 在 类 定义 中 重 载 这 些 运算 符 。 对 于 其 他 类 型 的 值 比较 ， 


可 使 用 实现 了 [Comparable 或 IComparer 接口 的 类 。 这 些 接口 特别 适用 于 集合 的 排序 
as 运算 符 可 使 用 as 运算 符 把 一 个 值 转换 为 引用 类 型 。 如 果 不 能 进行 转换 ，as 运算 符 就 返回 null 值 
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本 章 源 代码 可 以 通过 本 书 合作 站 点 wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapterl2 文件 夹 中 并 已 根据 本 章 示 例 的 
名 称 单独 命名 . 


本 章 首 先 介绍 泛 型 (generic) 的 概念 ， 先 学 习 抽 象 的 泛 型 术语 ， 因 为 学 习 泛 型 的 概念 对 高 效 使 用 它 是 至 关 重 
要 的 。 

接着 讨论 NET Framework 中 的 一 些 泛 型 类 型 ,这 有 助 于 更 好 地 理解 其 功能 和 强大 之 处 ， 以 及 在 代码 中 需要 
使 用 的 新 语法 。 然 后 定义 日 己 的 泛 型 类 型 ， 包 括 泛 型 类 、 接 口 、 方 法 和 委托 。 还 要 介绍 进一步 定制 泛 型 类 型 的 
其 他 技术 : default 关键 字 和 类 型 约束 。 

最 后 讨论 协 变 (covariance) 和 抗 变 (contravariance)， 这 是 C£ 4 引入 的 两 种 形式 的 变 体 ， 它 们 在 使 用 泛 型 类 时 
提供 了 更 大 的 灵活 性 。 


12.1 泛 型 的 含义 


为 介绍 泛 型 的 概念 ， 说 明 它 们 为 什么 这 么 有 用 ， 先 回顾 一 下 第 1 半 中 的 集合 类 。 基 本 集合 可 以 包含 在 诸如 
ArrayList 的 类 中 ， 但 这 些 集合 是 没有 类 型 化 的 ， 所 以 宕 要 把 object 项 转换 为 集合 中 实际 存储 的 对 象 类 型 。 继 承 
H System.Object 的 任何 对 象 都 可 以 存储 在 ArrayList 中 ， 所 以 要 特别 仔细 。 假 定 包含 在 集合 中 的 某 些 类 型 可 能 
导致 抛 出 异常 ， 而 且 代 码 逻 辑 朋 尝 。 前 面 介绍 的 技术 可 以 处 理 这 个 问题 ， 包 括 检查 对 象 类 型 所 十 的 代码 。 

但 是 ， 更 好 的 解决 办 法 是 一 开始 就 使 用 强 类 型 化 的 集合 类 。 这 种 集合 类 派生 于 CollectionBase， 并 可 以 拥有 
目 己 的 方法 ， 来 添加 、 删 除 和 访问 集合 的 成 员 ， 但 它 可 能 把 集合 成 员 限 制 为 派生 于 茶 种 基本 类 型 ， 或 者 必须 文 
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持 和 个 接口 。 这 会 市 来 一 个 问题 。 每 次 创建 需要 包含 在 集合 中 的 新 类 时 ， 束 必须 执行 下 列 任务 之 一 : 

e 使 用 茶 个 集合 类 ， 该 类 已 经 定义 为 可 以 包含 新 类 型 的 项 。 

e 创建 一 个 新 的 集合 类 ， 它 可 以 包含 新 类 型 的 项 ， 实 现 所 有 需要 的 方法 。 

一 般 情况 下 ， 新 的 类 型 需要 所 外 功能 ， 所 以 第 弟 需 要 用 到 新 的 集合 类 ， 因 此 创建 集合 类 会 花费 大 量 时 间 。 

男 一 方面 ， 沁 型 类 大 大 和 便 化 了 这 个 问题 。 汉 型 类 是 以 实例 化 过 程 中 提供 的 类 型 或 类 为 基础 建立 的 ， 可 以 坚 
不 费力 地 对 对 象 进行 强 类 型 化 。 对 于 集合 ,创建 “T 类 型 对 象 的 集合 ”十 分 简单 ， 只 需要 编写 一 行 代码 即 可 。 
不 使 用 下 面 的 代码 : 


CollectionClass items = new CollectionClass(); 
items.Add(new ItemClass()): 


而 是 使 用 : 


CollectionClass<ItemClass> items = new CollectionClass<Itemclass>(); 
items.Add(new ItemClass()); 


Adi Ss Hye ARE XU EZ WX. FEE TRIS. 3E CollectionClass <ItemClass> 看 成 
ItemClass 的 CollectionClass. 当然 ， 本 章 后 面 会 详细 探讨 这 个 语法 。 

泛 型 不 只 涉及 集合 ,但 集合 特别 适合 使 用 泛 型 。 本 章 后 和 面 介绍 System.Collections.Generic 名 称 空间 时 会 看 到 
这 一 点 。 创 建 一 个 泥 型 类 ， 就 可 以 生成 一 些 方 法 ， 它 们 的 签名 可 以 强 类 型 化 为 我 们 需要 的 任何 类 型 ， 该 类 型 其 
至 可 以 是 值 类 型 或 引用 类 型 ,处 理 各 目的 操作 。 还 可 以 把 用 于 实例 化 泛 型 类 的 类 型 限制 为 文 持 某 个 给 定 的 接口 ， 
或 派生 目 某 种 类 型 ， 从 而 只 允许 使 用 类 型 的 一 个 子 集 。 泛 型 并 不 限于 类 ， 还 可 以 创建 泛 型 接口 、 泛 型 方法 (可 以 
在 非 泛 型 类 上 定义 )， 其 至 泛 型 委托 。 这 将 极 大 地 提 融 代码 的 灵活 性 ， 正 确 使 用 沁 型 可 以 显 着 绚 短 开发 时 间 。 


对 于 熟悉 CH 的 读者 来 说 ， 这 是 CH 模板 和 C# 泛 型 类 的 一 个 区 别 。 在 C++ 中 ， 编 译 器 可 以 检测 出 在 哪里 使 
用 了 模板 的 某 个 特定 类 和 型， 例如， 模板 也 的 A 类 型 ， 然 后 编译 需要 的 代码 ， 来 创建 这 个 类 型 。 而 在 CHF, MA 
操作 都 在 运行 期 间 进行 。 


那么 该 如 何 实 现 沁 型 呢 ? 通 弟 ， 在 创建 类 时 ， 它 会 编 详 为 一 个 类 型 ， 然 后 在 代码 中 使 用 。 读 者 可 能 认为 ， 
在 创建 沁 型 类 时 ， 它 只 有 被 编 详 为 许多 类 型 ， 才 能 进行 实例 化 。 垃 好 并 不 是 这 样 :在 .NET 中 ， 类 有 无 限 多 个 。 
在 后 台 ，.NET 运行 库 允 许 在 需要 时 动态 生成 泛 型 类 。 在 实例 化 之 前 ，B 的 某 个 泛 型 类 A 甚至 不 存在 。 


12.2 ”使 用 泛 型 


在 探讨 如 何 创建 自己 的 泛 型 类 型 之 前 ， 首 先 介 绍 NET Framework 提供 的 泛 型 ， 包 括 System Collections.Generic 
名 称 空间 中 的 类 型 , 这 个 名 称 空 间 已 在 前 面 的 代码 中 出 现 过 多 次 , 因为 默认 情况 下 它 包含 在 控制 台 应 用 程序 中 。 
我 们 还 没有 使 用 过 这 个 名 称 空间 中 的 类 型 ， 但 下 面 就 要 使 用 了 。 本 节 将 讨论 这 个 名 称 空 间 中 的 类 型 ， 以 及 如 何 
使 用 它们 创建 强 类 型 化 的 集合 ， 改 进 已 有 集合 的 功能 。 

首先 论述 另 一 个 较 简 单 的 泛 型 类 型 ， 即 可 空 类 型 (nullable type)， 它 解决 了 值 类 型 的 一 个 小 问题 。 
12.2.1 可 空 类 型 

前 面 的 章节 介绍 了 值 类 型 (大 多 数 基 本 类 型 , 例如 , int、double 和 所 有 结构 ) 区 别 于 引用 类 型 (string 和 任意 类 ) 
的 一 种 方式 : 值 类 型 必须 包含 一 个 值 ， 它 们 可 以 在 声明 之 后 、 赋 值 之 前 ， 在 未 赋值 的 状态 下 存在 ， 但 不 能 使 用 
未 赋值 的 变量 。 而 引用 类 型 可 以 是 null. 

有 时 让 值 类 型 为 空 是 很 有 用 的 (尤其 是 处 理 数据 库 时 ), EH System.Nullable<T> 关 型 提供 了 使 值 类 型 为 
空 的 一 种 方式 。 例 如 : 


System.Nullable<int> nullableInt; 
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这 行 代码 声明 了 一 个 变量 pullableInt， 它 可 以 拥有 int 变量 能 包含 的 任意 值 ， 还 可 以 拥有 值 ool。 所 以 可 以 
编写 如 下 的 代码 : 

nullableInt = null; 

如 果 nullableInt 是 一 个 int 类 型 的 变量 ， 上 面 的 代码 是 不 能 编 详 的 。 

前 面 的 赋值 等 价 于 : 


nullableInt = new System.Nullable<int>(); 

与 其 他 任意 变量 一 样 ， 无 论 是 初始 化 为 nall(ft Hl. Tlf BTE). 还 是 通过 给 它 赋 值 来 初始 化 ， 部 不 能 在 初始 
化 之 前 使 用 它 。 

可 以 像 测试 引用 类 型 一 样 测试 可 空 关 型 ， 看 看 它们 是 否 为 null; 


if (nullableInt == null) 
{ 


s 
另外 ， 可 使 用 HasValue 属性 : 


if (nullableInt.HasValue) 
{ 


— 

这 不 适用 于 引用 类 型 ， 即 使 引用 类 型 有 一 个 HasValue 属性 ， 也 不 能 使 用 这 种 方法 ， 因 为 引用 类 型 的 变量 值 
为 null 就 表示 不 存在 对 象 ， 当 然 就 不 能 通过 对 象 来 访问 这 个 属性 ， 否 则 会 抛 出 一 个 异常 。 

可 使 用 Value 属 性 来 查看 可 空 类 型 的 值 。 如 果 HasValue 是 ttue， 就 说 明 Value 属 性 有 一 个 非 空 值 。 但 如 果 
HasValue 是 false， 就 说 明 变 量 被 赋予 了 null, 访问 Value 属 性 会 抛 出 System. InvalidOperationException2ZS?t M] H © 

可 空 闫 型 非 第 有 用 ， 以 至 于 它们 修改 了 C# 语 法 。 声 明 可 空 类 型 的 变量 不 使 用 上 述 语法 , 而 是 使 用 下 面 的 
语法 : 

int? nullableInt; 

其 中 int ?是 System Nullable=int> 的 缩写 ， 但 更 便于 读 取 。 下 面 就 会 使 用 这 个 语法 。 

1. 运算 符 和 可 空 类 型 

对 于 简单 类 型 (如 int)， 可 以 使 用 +、- 等 运算 符 来 处 理 值 。 而 对 于 对 应 的 可 空 类 型 ， 这 是 没有 区 别 的 : 包含 
在 可 衬 类 型 中 的 值 会 隐 式 转换 为 需要 的 类 型 ， 使 用 适当 的 运算 符 。 这 也 适用 于 结构 和 目 己 提供 的 运算 符 。 例 如 ; 

cuc uc opl * 27 

注意 ， 其 中 result 变量 的 类 型 也 是 int?。 下 面 的 代码 不 会 被 编译 : 

int? opl = 5; 

int result = opl * 2; 

为 使 上 面 的 代码 正 贡 工作 ， 必 须 进 行星 式 转换 ; 


int? opl = 5; 
int result = (int)opl * 2; 


或 通过 Value 属性 访问 值 : 


int? opl = 5; 
int result = opl.Value * 2; 


只 要 opl 有 一 个 值 ， 上 面 的 代码 就 可 以 正 第 运行 。 如 果 opl 是 mull， 就 会 生成 System InvalidOperationException 
类 型 的 异常 。 
这 就 引出 了 一 个 很 明显 的 问题 ， 当 运算 表达 式 中 的 一 个 或 两 个 值 是 null 时， 例如， 下 面 代码 中 的 op1， 会 
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发 生 什 么 情况 ? 

int? opl = null; 

int? op2 = 5; 

int? result = opl * op2; 

答案 是 : 对 于 除了 bool? 外 的 所 有 简单 可 空 类 型 ， 该 操作 的 结果 是 nul， 可 以 把 它 解释 为 “不 能 计算 ”。 对 
于 结构 ， 可 以 定义 目 己 的 运 复 符 来 处 理 这 种 情况 ( 详 见 本 章 后 面 的 内 容 )。 对 于 bool?, A&A | 定义 的 运算 符 会 
得 到 非 空 返 回 值 ， 这 些 运 算 符 的 结果 十 分 符合 逻辑 ， 如 果 不 需要 知道 其 中 一 个 操作 数 的 值 即 可 计算 出 结果 ， 则 

2. ?3? 运 算 符 

为 进一步 减少 处 理 可 空 类 型 所 需 的 代码 量 ， 使 可 空 变量 的 处 理 变 得 更 简单 ， 可 以 使 用 ?? 运 算 从 。 这 个 运算 
符 称 为 空 接合 运算 人 符 ull coalescing operator)， 是 一 个 二 元 运算 件 ， 人 允许 给 可 能 等 于 null 的 表达 式 提 供 另 一 个 值 。 
如 果 第 一 个 操作 数 不 是 null， 该 运 复 符 束 等 于 第 一 个 操作 数 ， 人 否则 ， 该 运算 符 束 等 于 第 二 个 操作 数 。 下 面 的 两 
个 表达 式 的 作用 是 相同 的 : 


opl ?? op2 
opl = null 2 op2 : opl 


在 这 两 行 代码 中 ，op1 可 以 是 任意 可 空 表达 式 ， 包 括 引用 类 型 和 更 重要 的 可 空 类 型 。 因 此 ， 如 果 可 空 类 型 
是 nul， 束 可 以 使 用 ?? 运 算 符 提 供 要 使 用 的 默认 值 ， 如 下 所 示 : 


int? opl = null; 
int result = opl * 2 77 D; 


在 这 个 示例 中 ，opl Æ null, ATLA op1*2 也 是 null。 但 是 ，?? 运 复 符 检测 到 这 个 情况 ， 并 把 值 WA result. 
这 里 要 特别 注意 ， 在 结 打 中 放 入 int 类 型 的 变量 result 不 需要 显 式 转换 。?? 运 复 符 会 目 动 处 理 这 个 转换 。 还 可 以 
把 ?? 表 达 式 的 结果 传 入 int? 中 : 


int? result = opl * 2 ?? 5; 


在 处 理 可 空 变 量 时 ，?? 运 算 符 有 许多 用 途 ， 它 也 是 一 种 提供 默认 值 的 便捷 方式 ， 不 需要 使 用 站 结构 中 的 代 
码 块 或 容易 引起 混 消 的 三 元 运算 符 。 

3. ?. BAF 

这 个 操作 符 通 沼 称 为 BE1vis 运算 符 或 空 条 件 运 复 待 ， 有 助 于 避免 束 洒 的 空 信 检查 造成 的 代码 监 义 。 例 如 ， 如 
果 想 得 到 给 定 客 户 的 订单 数 ， 就 需要 在 设置 计数 值 之 前 检查 空 值 : 

int count = 0; 


if (customer.orders ! = null) 
{ 
count = customer.orders.Count(); 
} 
如 果 只 编写 了 这 段 代 码 ， 但 客户 没有 订单 ( 即 为 pu]， 就 会 抛 出 System. ArgumentNullException: 


int count = customer.orders.Count (); 

EH ZRI. ZE int? count WAA null, mi^ 4«m—Tugs. 

int? count = customer.orders?.Count(); 

结合 上 一 节 讨 论 的 空 合并 操作 符 ?? 与 空 条 件 运 算 符 ?. 可 以 在 结果 是 null 时 设置 一 个 默认 值 。 

int? count = customer.orders?.Count() ?? 0; 

28 RPI MUN IN A ee f SF. 第 13 章 详 细 讨 论 了 事件 . A SPN E LT 12:6 f HH a BRS 
模式 : 

var onChanged = OnChanged; 


if (onChanged != null) 
{ 
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onChanged(this, args); 
} 


这 种 模式 不 是 线程 安全 的 ， 因 为 有 人 会 在 null 检查 已 经 完成 后 ， 退 订 最 后 一 个 事件 处 理 程序 。 此 时 会 抛 册 
异常 ， 程 序 骨 溃 。 使 用 空 条 件 运 算 符 可 以 避免 这 种 情形 : 


OnChanged?.Invoke (this, args); 


注意 : 


如 果 使 用 运算 符 重 载 方法 (例如 一 )， 但 没有 检查 null， 就 会 抛 出 System.NullReferenceException. 
运算 符 章 载 中 ， 使 用 ?. 运 算 付 


如 第 11 章 所 述 ， 在 C:\BeginningCSharp7\Chapter12\Ch12CardLib\Card.cs 类 的 
检查 null， 可 以 避免 在 使 用 该 方法 时 抛 出 异常 。 例 如 : 


public static bool operator ==(Card cardl, Card card2) 
=> (cardl?.suit == card??.suit) && (cardl?.rank == card2?.rank): 


在 语句 中 包括 空 条 件 运 算 行 ， 就 清楚 地 表示 : 如 果 左 边 的 对 象 (在 本 例 中 是 card] BK card2) 不 为 空 ， 就 检索 
右边 的 对 象 。 如 果 左 边 的 对 象 为 空 ( 即 card] 或 card2)， 就 终止 访问 链 ， 返 回 null. 

4. 使 用 可 空 类 型 

在 下 面 的 示例 中 ， 将 介绍 可 空 类 型 Vector。 


试 一 试 ” 可 空 类 型 : Ch12Ex01 


(1) 在 C:\BeginningCSharp7\Chapter12 目录 中 创建 一 个 新 的 控制 台 应 用 程序 项 目 Ch12Ex01。 
(2) 在 文件 Vector.es 中 添加 一 个 新 类 Vector. 
(3) 修改 Vector.cs 中 的 代码 ， 如 下 所 示 : 


using static System.Math; 
public class Vector 


{ 
public double? R = null; 
public double? Theta = null; 
public double? ThetaRadians 
{ 
// Convert degrees to radians. 
get { return (Theta * Math.PI / 180.0); } 
} 
public Vector (double? r, double? theta) 
{ 
// Normalize. 
if (r < 0) 
{ 
r= -r; 
theta += 180; 
} 
theta = theta % 360; 
// Assign fields. 
R= fr; 
Theta = theta; 
} 
public static Vector operator +(Vector opl, Vector op2) 
{ 
try 
{ 
// Get (x, y) coordinates for new vector. 
double newX = opl.R.Value * Sin(opl.ThetaRadians.Value) 
+ op2.R.Value * Sin(op2.ThetaRadians.Value); 
double newY — opl.R.Value * Cos(opl.ThetaRadians.Value) 
+ op2.R.Value * Cos(op2.ThetaRadians.Value); 
// Convert to (r, theta). 
double newR = Sqrt(newX * newX + newY * newY); 
double newTheta = Atan2(newX, newY) * 180.0 / PI; 
// Return result. 
return new Vector(newR, newTheta); 
} 
catch 


{ 
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// Return "null" vector. 
return new Vector(null, null); 


} 

public static Vector operator -(Vector opl) => new Vector(-opl.R, opl.Theta) ; 
public static Vector operator -(Vector opl, Vector op2) => opl + (-op2); 
public override string ToString() 


{ 
// Get string representation of coordinates. 
string rString = R.HasValue ? R.ToString(): "null"; 
string thetaString - Theta.HasValue ? Theta.ToString(): "null"; 
// Return (r, theta) string. 
return string.Format($"((rString), {thetaString})"); 
} 


(4) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


class Program 
{ 

static void Main(string[] args) 

{ 
Vector vl = GetVector("vectorl"); 
Vector v2 = GetVector("vectorl"); 
WriteLine($"(vl) + (v2) = (vl + v2}"); 
WriteLine($"(vl) - { v2} = {vl - v2)"); 
ReadKey () ; 

} 

static Vector GetVector(string name) 

{ 
WriteLine($"Input (name) magnitude:") ; 
double? r = GetNullableDouble(); 
WriteLine($"Input {name} angle (in degrees):"); 
double? theta = GetNullableDouble |(); 
return new Vector(r, theta); 

) 

static double? GetNullableDouble() 

{ 
double? result; 
string userInput = ReadLine(); 
try 
{ 

result = double.Parse(userInput); 

} 
catch 
{ 


null; 


result 


) 


return result; 


} 
(5) 执行 该 应 用 程序 ， 给 两 个 矢量 (vecton) 输 入 值 ， 示 例 输 出 结果 如 图 12-1 所 示 。 


Lo; ww Jj 


12-1 


(6) 再 次 执行 应 用 程序 ， 这 次 跳 过 四 个 值 中 的 至 少 一 个 ， 示 例 输出 结果 如 图 12-2 所 示 。 
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12-2 


示例 说 明 
在 这 个 示例 中 ， 创 建 了 一 个 类 Vector， 它 表示 市 极 坐标 (有 一 个 幅 值 和 一 个 角度 ) 的 矢量， 如 图 12-3 所 示 。 


y 


12-3 


坐标 r 和 9 在 代码 中 用 公共 字段 R 和 Theta 表示 ， 其 中 Theta 的 单位 是 度 (*)。ThetaRadians 用 于 获取 Theta 
的 弧度 值 ， 这 是 必需 的 ， 因 为 Math 类 在 其 静态 方法 中 使 用 的 是 弧度 。R 和 Theta 的 类 型 都 是 double?， 所 以 它 
们 可 以 为 空 : 


public class Vector 


{ 
public double? R = null; 
public double? Theta = null; 
public double? ThetaRadians 


{ 
get 
// Convert degrees to radians. 
return (Theta * PI / 180.0); 
} 
} 


Vector [ic EF BUELL R 和 Theta 的 初始 值 ， 然 后 赋 给 公共 字段 。 


public Vector (double? r, double? theta) 
{ 
// Normalize. 
if (r < 0) 
{ 
E = PE 
theta += 180; 
} 
theta = theta % 360; 
// Assign fields. 
R = r}; 
Theta = theta; 
} 


Vector 类 的 主要 功能 是 使 用 运算 符 重 载 对 天 量 进行 相 加 和 相 减 运算 , ig 32 HEE EAR = £8 PAA, 
这 里 不 解释 它们 ， 相 关内 容 可 以 访问 站 点 http:Wwww.onlinemathleaming.comybasic-tigonometryhtml， 或 者 在 互联 网 
上 搜索 其 他 资源 。 在 代码 中 ， 重 要 的 是 ， 如 果 在 获取 RR 或 ThetaRadians 的 Value 属性 时 抛 出 了 异常 ， 即 其 中 一 
个 是 null, WEE ""E" RE. 


public static Vector operator +(Vector opl, Vector op2) 


{ 
try 
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// Get (x, y) coordinates for new vector. 


catch 


// Return "null" vector. 
return new Vector(null, null); 
} 
} 


如 果 组 成 矢量 的 一 个 坐标 是 null， 该 矢量 就 是 无 效 的 ， 这 里 用 R 和 Theta 都 可 为 null 的 Vector 类 来 表示 。 
Vector 类 的 其 他 代码 重 写 了 其 他 运算 符 ， 以 便 扩 展 相 加 的 功能 ， 使 其 包含 相 减 操 作 ， 再 重 写 ToStringO. H 
Vector 对 象 的 字符 串 表 示 。 

Program.cs 中 的 代码 测试 Vector 类 ， 让 用 户 初始 化 两 个 天 量 ， 再 对 它们 进行 相 加 和 相 减 。 如 果 用 户 省 略 了 
革 个 值 ， 该 值 就 被 解释 为 null， 应 用 前 面 提 及 的 规则 。 


12.2.2 System.Collections.Generic 名 称 空间 
实际 上 ， 本 书 前 面 的 每 个 应 用 程序 都 包含 如 下 名 称 空间 : 


using System; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

using System. Threading. Tasks; 
using static System.Console; 


System 名 称 空间 包含 NET 应 用 程序 使 用 的 大 多 数 基 本 类 型 。 
System.Collections.Generic 名 称 空间 包含 用 于 处 理 集合 的 泛 型 类 型 ， 茹 与 using 语句 一 起 使 用 。 
System.Linq 名 称 空间 将 在 本 书后 和 面 介绍 。 
System. Text 名 称 空间 包含 与 字符 串 处 理 和 编 妈 相关 的 类 型 。 
System.Threading.Tasks 名 称 空间 包含 帮助 编写 异步 代 人 码 的 类 型 ， 本 书 不 予 讨论 。 
在 编写 控制 台 应 用 程序 时 using static System.Console 声明 很 有 帮助 。 手 动 添加 该 声明 后 ， 在 WriteLine() 和 
ReadLine0O 函 数 前 不 必 多 次 编写 Console. 

下 面 介 绍 这 些 沁 型 类 型 ， 它 们 可 以 使 工作 更 容易 完成 ， 可 以 量 不 费力 地 创建 强 关 型 化 的 集合 类 。 表 12-1 f 
述 了 本 节 要 介绍 的 System.Collections.Generic 名 称 空 轩 中 的 两 个 类 型 ， 本 章 后 面 还 会 详细 曾 述 这 个 名 称 空 团 中 
的 更 多 类 型 。 


表 12-1 泛 型 集合 类 型 
类 型 说 明 
List<T> T 类 型 对 象 的 集合 
Dictionary<K, V> 与 民 类 型 的 键 值 相关 的 V 类 型 的 项 的 集合 


本 节 还 会 介绍 和 这 些 类 一 起 使 用 的 各 种 接口 和 委托 。 

1. List<T> 

List<T> 泛 型 集合 类 型 更 快捷 、 更 便于 使 用 ， 这 样 ， 就 不 必 像 上 一 章 那样 ， 从 CollectionBase 中 派生 一 个 类 ， 
然后 实现 需要 的 方法 。 它 的 男 一 个 好 处 是 正常 情 况 下 需要 实现 的 许多 方法 (例如 ，Add0) 已 经 目 动 实现 了 。 

创建 工 类 型 对 象 的 集合 需要 如 下 代码 : 

List<T> myCollection = new List<T>(); 

这 就 足够 了 。 未 必要 定义 类 、 实 现 方法 或 执行 其 他 操作 。 还 可 以 把 List<T> 对 象 传递 给 构造 函数 ， 在 集合 
中 设置 项 的 起 始 列表 。List<T> 还 有 一 个 Item 属性 ， 人 允许 进行 类 似 于 数组 的 访问 ， 如 下 所 示 : 
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T itemAtIndex2 = myCollectionofT [2]; 


IPRA HAJLA A, (AR Ee S ERA, MEn Wea EZR SP a ru 
何 实际 使 用 List<T>. 


试 一 试 ” 使 用 List<T>: Ch12Ex02 


(1) 在 C:\BeginningCSharp7\Chapter12 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch12Ex02。 

(2) 在 Solution Explorer 窗口 中 右 击 项 目 名 称 ， 选 择 Add | Existing Item 选项 。 

(3) 在 Ci\BeginningCSharpp7\Chapter11\Ch11Ex01\ 目 录 中 选择 Animal.cs、Cow.cs 和 Chicken.cs 文件 , "Hi: Add 
按钮 。 

(4) 修改 这 3 个 文件 中 的 名 称 空间 声明 ， 如 下 所 示 : 


namespace Ch12Ex02 


(5) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 

static void Main(string[] args) 

{ 
List<Animal> animalCollection = new List<Animal>(); 
animalCollection.Add(new Cow("Rual")); 
animalCollection.Add(new Chicken("Donna")); 
foreach (Animal myAnimal in animalCollection) 
{ 

myAnimal .Feed() ; 

} 
ReadkKey () ; 

} 


(6) 执行 该 应 用 程序 ， 结 果 与 第 11 FY Chl1Ex02 的 结果 相同 。 


示例 说 明 
这 个 示例 与 Ch11Ex02 只 有 两 个 区 别 。 第 一 个 区 别 是 下 面 的 代码 行 : 
Animals animalCollection = new Animals(); 
被 替换 为 : 
List<Animal> animalCollection = new List<Animal>(); 
第 二 个 区 别 比较 重要 : 项 目 中 不 再 有 Animals 集合 类 。 通 过 使 用 泛 型 集合 类 ， 前 面 为 创建 这 个 类 所 做 的 工 
作 现 在 用 一 行 代 码 即 可 完成 。 
获得 相同 效果 的 另 一 个 方法 是 不 修改 Program.cs 中 的 代码 ， 而 是 使 用 Animals 的 如 下 定义 : 
public class Animals : List<Animal> {} 
这 么 做 的 优点 是 ， 能 较 容 易 地 看 异 Program.cs 中 的 代码 ， 还 可 以 在 合适 时 给 Animals 类 添加 成 员 。 
2. 对 泛 型 列表 进行 排序 和 搜索 
对 泛 型 列表 进行 排序 与 对 其 他 列表 进行 排序 是 一 样 的 。 第 11 章 介 绍 了 如 何 使 用 IComparer 和 [Comparable 
接口 比较 两 个 对 象 ， 然 后 对 该 类 型 的 对 象 列表 排序 。 这 里 唯一 的 区 别 在 于 ， 可 使 用 泛 型 接口 IComparer<T> 和 
IComparable<T>， 它 们 提供 了 略 有 区 别 的 、 和 针对 特定 类 型 的 方法 。 表 12-2 列 出 了 它们 之 间 的 区 别 。 


表 12-2 ”对 泛 型 列表 进行 排序 


o jx 非 泛 型 方法 区 Al 
int IComparable<T> int IComparable 在 泛 型 版 本 中 是 强 类 型 化 的 


.CompareTo(T otherOb]) .CompareTo (object otherObj) 


bool IComparable<T> 


在 非 泛 型 接口 中 不 存在 ， 可 以 改 用 继 
.Equals(T otherObj) Æ} object.Equals( ) 
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泛 型 方法 非 泛 型 方法 


int IComparer<T>.Compare int [Comparer 


(T objectA, T objectB) 


bool IComparer<T>.Equals 


object objectB) 


(T objectA, T objectB) 


int IComparer«T» N/A 


.GetHashCode(T objectA) 


.Compare(object objectA, 


( 续 表 ) 


区 Fl 
在 泛 型 版 本 中 是 强 类 型 化 的 


在 非 泛 型 接口 中 不 存在 ， 可 以 改 用 继 
承 的 object.Equals( ) 

在 非 泛 型 接口 中 不 存在 ， 可 以 改 用 继 
承 的 object. GetHashCode ( ) 


要 对 List<T> 排 序 ， 可 以 在 要 排序 的 类 型 上 提供 IComparable<T> 接 口 ， 或 者 提供 IComparer<T> 接 口 。 另 外 ， 还 
可 以 提供 这 型 委托 ， 作 为 排序 方法 。 从 了 解 代 码 工作 原理 的 角度 看 ， 这 非常 有 趣 ， 因 为 实现 上 述 接口 并 不 比 实 
MERZ ERA ER. 
一 般 情 况 下 ， 给 列表 排序 需要 有 一 个 方法 来 比较 两 个 类 型 的 对 象 。 要 在 列表 中 搜索 ， 只 需要 一 个 方法 
Xs fr 工 类 型 的 对 销 ， 看 它 是 人 否 满 正 茶 个 条 件 。 定 义 这 样 的 方法 很 何 单 ， 这 里 给 出 两 个 可 以 使 用 的 这 型 委托 


类 型 


e Comparison<T>: 这 个 委托 类 型 用 于 排序 方法 ， 其 返回 类 型 和 参数 如 下 : 


int method(T objectA, T objectB) 


e Predicate<T>: 这 个 委托 类 型 用 于 搜索 方法 ， 其 返回 类 型 和 参数 如 下 : 


bool method(T targetobject) 


可 以 定义 任意 多 个 这 样 的 方法 ， 使 用 它们 实现 List<T> 的 搜索 和 排序 方法 。 下 面 的 示例 进行 了 演示 。 


试 一 试 ”List<T> 的 搜索 和 排序 : Ch12Ex03 


(1) 在 C:\BeginningCSharp7\Chapter12 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch12Ex03. 

(2) 在 Solution Explorer 窗口 中 右 击 项 目 名 称 ， 然 后 选择 Add Existing Item 选项 。 

(3) 在 C:\BeginningCSharp7\Chapter12\Ch12Ex01 目录 中 选择 Vectorcs 文件 ， 单 击 Add 按钮 。 
(4) 修改 这 个 文件 中 的 名 称 衬 间 声明 ， 如 下 所 示 : 


namespace Ch12Ex03 


(5) 添加 一 个 新 类 Vectors. 
(6) 修改 Vectors.cs 中 的 代码 ， 如 下 所 示 : 


public class Vectors : List<Vector> 


{ 


public Vectors () 
{ 
} 
public Vectors (IEnumerable<Vector> initialltems) 
{ 
foreach (Vector vector in initialltems) 
{ 
Add (vector); 
} 
} 
public string Sum() 
{ 
StringBuilder sb = new StringBuilder (); 
Vector currentPoint = new Vector(0.0, 0.0); 
sb.Append ("origin"); 
foreach (Vector vector in this) 


{ 
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sb.AppendFormat ($" + {vector}"); 
currentPoint += vector; 
} 
sb.AppendFormat ($" = {currentPoint}"); 
return sb.ToString(); 
} 
} 


(7) 添加 一 个 新 类 VectorDelegates. 
(8) 修改 VectorDelegates.cs 中 的 代码 ， 如 下 所 示 : 


public static class VectorDelegates 

{ 

public static int Compare(Vector x, Vector y) 

{ 
if (x.R > y.R) 
{ 


return 1; 


} 
else if (x.R € y.R) 
{ 
return -1; 
} 


return 0; 


} 

public static bool TopRightQuadrant (Vector target) 
{ 
if (target.Theta >= 0.0 && target.Theta <= 90.0) 
{ 


return true; 
} 
else 
{ 

return false; 


} 


} 
(9) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


static void Main(string[] args) 
{ 
Vectors route = new Vectors (); 
route.Add(new Vector(2.0, 90.0)); 
route.Add(new Vector(1.0, 180.0)); 
route.Add(new Vector(0.5, 45.0)); 
route.Add(new Vector(2.5, 315.0)); 
WriteLine (route.Sum()); 
Comparison<Vector> sorter = new Comparison<Vector> ( 
VectorDelegates.Compare) ; 
route.Sort (sorter); 
WriteLine (route.Sum()); 
Predicate<Vector> searcher = 
new Predicate<Vector> (VectorDelegates .TopRightQuadrant) ; 
Vectors topRightQuadrantRoute = new Vectors (route.FindAll (searcher) ) ; 
WriteLine (topRightQuadrantRoute.Sum()); 
ReadkKey () ; 
} 


(10) 执行 应 用 程序 ， 结 果 如 图 12-4 所 示 。 


示例 说 明 

在 这 个 示例 中 ， 为 Ch12Fx01 中 的 Vector 类 创建 了 一 个 集合 类 Vectors。 可 以 只 使 用 List<Vector 关 型 的 变量 ， 
但 因为 需要 其 他 功能 ， 所 以 使 用 了 一 个 新 类 Vectors， 它 派生 自 List<Vector>， 人 允许 添加 需要 的 其 他 成 员 。 

该 类 有 一 个 返回 字符 串 的 成 员 Sum0， 访 字符 串 依 次 列 出 每 个 天 量 ， 以 及 把 它们 加 在 一 起 (使 用 源 类 Vector 


226 | 第 | 部 分 Cit BE 


的 重 载 + 运 算 符 ) 的 结果 。 每 个 矢量 都 可 以 看 成 “ 方 癌 + 距离 >”， 所 以 这 个 矢量 列表 构成 了 一 条 有 端点 的 路 径 。 
public string Sum() 
{ 
StringBuilder sb = new StringBuilder (); 
Vector currentPoint = new Vector(0.0, 0.0); 
sb.Append ("origin"); 
foreach (Vector vector in this) 
[ 
sb.AppendFormat ($" + [vector]"); 
currentPoint += vector; 
} 
Sb.AppendFormat($" = {currentPoint}"); 
return sb.ToString(); 
} 

该 方法 使 用 System.Text 名 称 空间 中 简便 的 StringBuilder 类 来 构建 啊 应 字符 串 。 这 个 类 包含 这 里 使 用 的 
Append0 和 AppendFormat0 等 成 员 ， 所 以 很 容易 组 合 字 符 串 ， 其 性 能 也 比 串 联 各 个 字符 串 要 癌 。 使 用 这 个 类 的 
ToStringO0 方 法 即 可 获得 最 终 字 符 串 。 

本 例 还 创建 了 两 个 用 作 委 托 的 方法 ， 作 为 VectorDelegates 的 静态 成 员 。CompareO 用 于 比较 (排序 )， 
TopRightQuadrantO 用 于 搜索 。 稍 后 在 分 析 Program.cs 中 的 代码 时 介绍 它们 。 

Main0 中 的 代码 育 先 初始 化 Vectors 集合 , 给 它 添 加 几 个 Vector 对 象 (这 段 代 码 包 含 在 Ch12Ex03\ Program.cs 
文件 中 ): 


Vectors route = new Vectors(); 

route .Add(new Vector(2.0, 90.0)); 
route.Add(new Vector(1.0, 180.0)); 
route.Add(new Vector(0.5, 45.0)); 
route.Add(new Vector(2.5, 315.0)); 


如 前 所 述 ，Vectors.Sum0 方 法 用 于 输出 集合 中 的 项 ， 这 次 是 按照 其 初始 顺序 输出 : 
WriteLine (route.Sum()); 
接 看 创建 第 一 个 委托 sorter， 这 个 委托 属于 Comparison<Vector> 关 型 ， 因 此 可 赋予 带 如 下 返回 类 型 和 参数 的 
方法 : 
int method(Vector objectA, Vector objectB) 


€ ILAE VectorDelegates.Compare(), 127] 14 REINA BENT. 


Comparison<Vector> sorter = new Comparison<Vector> ( 
VectorDelegates.Compare); 


Compare0O 比 较 两 个 天 量 的 大 小 ， 如 下 所 示 : 


public static int Compare (Vector x, Vector y) 


i if (X.R > y.R) 
l return 1; 
T if (x.R < y.R) 
i return -1; 
— DF 

} 


这 样 就 可 以 按 大 小 对 矢量 排序 了 : 


route.Sort (sorter); 
WriteLine (route.Sum()); 


Jv, FEE PP TAG) Hi f RAE BATT 7 H9 45 Re — EHI, ATC eT IAT NR“ 
Bre” Mim ie A IA A 

然后 进行 搜索 ， 获 取 集 合 中 的 一 个 天 量子 集 。 这 需要 使 用 VectorDelegates. TopRightQuadrant() CEH: 

public static bool TopRightQuadrant (Vector target) 


{ 
if (target.Theta >= 0.0 && target.Theta <= 90.0) 
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{ 


return true; 


} 
else 


{ 


} 
} 


如 果 该 方法 的 Vector 参数 的 Theta 的 值 介 于 0"” 一 90"” 之 间 ， 就 返回 tue， 也 就 是 说 ， 它 在 前 面 的 排序 图 
H ERA. 
在 Main(0 方 法 中 ， 通 过 Predicate<Vector> 类 型 的 委托 使 用 这 个 方法 ， 如 下 所 示 : 


Predicate<Vector> searcher = 

new Predicate<Vector> (VectorDelegates.TopRightQuadrant) ; 
Vectors topRightQuadrantRoute = new Vectors (route.FindAll (searcher) ); 
WriteLine (topRightQuadrantRoute.Sum()); 


这 需要 在 Vectors 中 定义 构造 函数 ; 


public Vectors (IEnumerable<Vector> initialltems) 


return false; 


{ 
foreach (Vector vector in initialltems) 
{ 
Add (vector); 
} 
} 


其 中 ， 使 用 IEnumerable<Vector 的 接口 初始 化 了 一 个 新 的 Vectors 集合 ， 这 是 必需 的 ， 因 为 List<Vector>. 
FindAll0 返 回 一 个 List<Vector> 实 例 ， 而 不 是 Vectors 实例 。 
搜索 的 结果 是 ， 只 返回 Vector 对 象 的 一 个 子 集 ， 所 以 汇总 结果 不 同 ( 这 正 是 我 们 希望 的 )。 使 用 这 些 泛 型 委 
托 类 型 来 排序 和 搜索 沁 型 集合 需要 一 段 时 间 才 能 习惯 ， 但 代码 更 加 流畅 局 效 了 ， 代 码 的 结构 更 富 逻 辑 性 。 最 好 
化 点 时 间 研 究 本 节 介 绍 的 技术 。 
男 外 ， 在 这 个 示例 中 ， 注 意 下 面 的 代码 : 
Comparison<Vector> sorter = new Comparison<Vector> ( 


VectorDelegates.Compare); 
route.Sort (sorter); 


可 简化 为 : 


route .Sort (VectorDelegates.Compare); 


这 样 就 不 需要 隐 式 引用 Comparison<Vector> 类 型 了 。 实 际 上 ， 仍 会 创建 这 个 类 型 的 一 个 实例 ， 但 它 是 隐 式 
创建 的 。 显 然 ，Sort0 方 法 需要 这 个 类 型 的 实例 才能 工作 ， 但 编译 器 会 认识 到 这 一 点 ， 在 我 们 提供 的 方法 中 目 动 
创建 该 类 型 的 实例 。 此 时 ， 对 VectorDelegates.CompareO0 的 引用 (没有 括号 ) 称 为 方法 组 (method group)。 许 多 情况 
下 ， 都 可 以 使 用 方法 组 以 这 种 方式 隐 式 地 创建 委托 ， 使 代码 变 得 更 易于 阅读 。 


3. Dictionary<K, V> 


Dictionary<K, V> 类 型 可 定义 键 / 值 对 的 集合 。 与 本 章 前 和 面 介 绍 的 其 他 泛 型 集合 类 型 不 同 ， 这 个 类 需要 实例 化 


两 个 类 型 ， 分 别 用 于 键 和 值 ， 以 表示 集合 中 的 各 个 项 。 

实例 化 Dictionary<K, V> 对 象 后 ， 就 可 以 像 在 继承 日 DictionaryBase 的 类 上 那样 ， 对 它 执 行 相同 的 操作 ， 但 
要 使 用 已 有 的 类 型 安全 的 方法 和 属性 。 例 如 ， 使 用 强 类 型 化 的 Add0 方 法 添加 键 / 值 对 。 

Dictionary<string, int> things = new Dictionary<string, int>(); 

things.Add("Green Things", 29); 

things.Add("Blue Things", 94); 

things.Add("Yellow Things", 34); 


things.Add("Red Things", 52); 
things.Add("Brown Things", 27); 


不 使 用 Add0 方 法 也 可 以 添加 键 / 值 对 ， 但 代码 看 起 来 不 是 太 优 雅 : 


Dictionary<string, int» things = new Dictionary<string, int>() { 
{"Green Things", 29}, 
{"Blue Things", 94}, 
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{"Yellow Things", 34}, 

{"Red Things", 52}, 

{"Brown Things", 27} 
Hu 
可 使 用 Keys 和 Values 属性 迭代 集合 中 的 键 和 值 : 
foreach (string key in things.Keys) 

WriteLine (key); 

} 
foreach (int value in things.Values) 


WriteLine (value); 


} 

还 可 以 迭代 集合 中 的 各 个 项 ， 把 每 个 项 作为 一 个 KeyValuePair<K，V> 实 例 来 获取 ， 这 与 第 11 章 介 绍 的 
DictionaryEntry 对 象 十 分 相似 : 

foreach (KeyValuePair<string, int> thing in things) 

| WriteLine ($"{thing.Key} = {thing.Value}"); 

对 于 Dictionary<K,V> 要 注意 的 一 点 是 ， 每 个 项 的 键 部 必须 是 唯一 的 。 如 果 要 添加 的 项 的 键 与 已 有 项 的 键 
相同 , 就 会 抛 出 ArgumentException 1+% - ATLA, Dictionary<K, V> 人 允许 把 IComparer<K> 接 口传 刻 给 其 构造 函数 。 
如 果 要 把 上 自己 的 类 用 作 键 ， 且 它们 不 文 持 [Comparable 或 IComparable<K> 接 口 ， 或 者 要 使 用 非 默 认 的 过 程 比较 
对 象 ， 束 必须 把 IComparer<K> 接 口传 雍 给 其 构造 函数 。 例如， 在 上 例 中 ， 可 以 使 用 不 区 分 大 小 写 的 方法 来 比较 


Dictionary<string, int> things = 
new Dictionary<string, int»(StringComparer.CurrentCultureIgnoreCase); 


如 果 使 用 下 和 面 的 键 ， 就 会 得 到 一 个 异 第 : 


things.Add("Green Things", 29); 
things.Add("Green things", 94); 


也 可 以 给 构造 函数 传递 初始 容量 (使 用 inb 或 项 的 集合 (使 用 IDictionary<K,V> 接 口 )。 
若 不 使 用 Add0 方 法 或 更 优雅 的 方法 来 填充 Dictionary<K, V> 类 型 ， 则 可 考虑 使 用 索引 初始 化 器 ， 它 支持 在 
XI 2913584588 V3 RD] ERI : 


var things = new Dictionary<string, int>() 


{ 
("Green Things"] = 29, 
["Blue Things"] = 94, 
("Yellow Things"] = 34, 
["Red Things"] = 52, 
["Brown Things"] = 27 


he 
Fel Pea Gas RF RAE 因为 在 许多 情况 下 都 不 需要 通过 var things 显示 临时 变量 ,使 用 表达 式 体 方法 ， 
上 例会 级 联 简化 的 作用 并 使 Dictionary<K. V> 类 型 的 初始 化 最 终 变 得 优雅 : 

public Dictionary<string, int> 

SomeThings() => new Dictionary<string, int> 
{ ["Green Things"] = 29, ["Blue Things"] = 94 }; 

4. 修改 CardLib 以 便 使 用 泛 型 集合 类 

对 前 几 间 创建 的 CardLib 项 目 可 以 进行 简单 的 修改 ， 即 修改 Cards 集合 类 ， 以 使 用 一 个 泛 型 集合 类 ， 这 将 
减少 许多 行 代码 。 对 Cards 的 类 定义 需要 做 如 下 修改 (这 段 代 码 包含 在 Ch12CardLib\Cards.cs 文件 中 ): 


public class Cards : List<Card>, ICloneable { ... } 


还 可 删除 Cards 的 所 有 方法 ,但 Clone0 和 CopyTo0 除 外 ,因为 Clone0O 是 ICloneable 需要 的 方法 , 而 List<Card> 
提供 的 CopyTo0 版 本 处 理 的 是 Card 对 象 数组 , 而 不 是 Cards 集合 .需要 对 Clone0 做 一 些 轻微 的 修改 ,因为 List<T> 
类 没有 定义 List 属性 : 
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public object CLone () 
{ 


Cards newCards = new Cards(); 
foreach (Card sourceCard in this) 
{ 
newCards.Add( (Card) sourceCard.Clone()); 
] 


return newCards; 


} 
这 里 没有 列 出 代码 ， 因 为 这 是 十 分 简单 的 修改 ，CardLib 的 更 新 版 本 为 Ch12CardLib， 它 与 第 11 RINE 
户 代码 包含 在 本 章 的 下 载 代码 中 。 


12.3 ”定义 泛 型 类 型 


利用 前 面 介 绍 的 泛 型 知识 ， 足 以 创建 自己 的 泛 型 了 。 前 面 的 许多 代码 都 涉及 泛 型 类 型 ， 并 且 还 介绍 了 多 个 
使 用 泛 型 语法 的 实例 。 本 节 将 定义 如 下 内 容 : 

e 泛 型 类 

e ZRH 

e iJ 

e 泛 型 委托 

在 定义 泛 型 类 型 的 过 程 中 ， 还 将 讨论 下 面 一 些 更 高 级 的 技术 : 

e default 关键 字 

e 约束 类 型 

e 从 泛 型 类 中 继承 

e 泛 型 运算 符 


123.4 定义 泛 型 类 
要 创建 泛 型 类 ， 只 需要 在 类 定义 中 包含 尖 括 号 语法 : 


class MyGenericClass<T> { ... } 


HPT u DEREN. HEGINER] C# 个 名 规则 即 可 ， 例 如 ， 不 以 数字 开头 等 。 但 一 般 只 使 用 工 。 
ZR ERE PATER STRESS S3 BB. DIA: 


class MyGenericClass<T1, T2, T3> { ... } 


定义 了 这 些 类 型 后 , 束 可 以 在 类 定义 中 像 使 用 其 他 类 型 那样 使 用 它们 。 BT DEE PE va EER 
、 属 性 或 方法 等 成 员 的 返回 类 型 以 及 方法 的 参数 类 型 等 。 例 如 : 


class MyGenericClass<Tl, T2, T3> 
{ 
private Tl innerTlob ject; 
public MyGenericClass(T1l item) 
{ 
innerTlObject = item; 


} 
public T1 InnerTlObject 
{ 


get { return innerTlObject; } 
} 
} 


Hp, 2878 T1 的 对 象 可 以 传递 给 构造 函数 ， 只 能 通过 InnerT1 Object 属性 对 这 个 对 象 进行 只 读 访问 。 注 意 ， 
不 能 假定 为 类 提供 了 什么 类 型 。 例 如 ， 下 面 的 代码 就 不 会 编译 


class MyGenericClass<Tl, T2, T3> 
{ 
private Tl innerTlObject; 
public MyGenericClass () 
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i innerTlObject = new T1(); 
LA T1 InnerTlObject 
' get ( return innerTlObject; } 

我 们 不 知道 TI 是 什么 ， 也 就 不 能 使 用 它 的 构造 函数 ， 它 甚至 可 能 没有 构造 函数 ， 或 者 没有 可 公共 访问 的 
默认 构造 了 责 数 。 如 果 不 使 用 涉及 本 市 后 面 介 绍 的 融 级 拉 术 的 复杂 代码 ， 则 只 能 对 TI 进行 如 下 假设 : 可 以 把 它 
看 成 继承 日 System.Object 的 类 型 或 可 以 封 箱 到 System.Object 中 的 类 型 。 

显然 ， 这 意味 着 不 能 对 这 个 类 型 的 实例 进行 非常 有 趣 的 操作 ， 或 者 对 为 MyGenericClass 泛 型 类 提供 的 其 他 
关 型 进行 有 趣 的 操作 。 不 使 用 反射 技术 (这 是 用 于 在 运行 期 间 检 查 类 型 的 高 级 技术 ， 第 13 BRP EAE), ABE 
使 用 下 面 的 代码 : 

public string GetAllTypesAsstring () 
return "T1 = " + typeof(T1).Tostring() 
+", T2 = " + typeof (T2) . Tostring () 


+", T3 = " + typeof (T3) .Tostring(); 
} 


可 以 做 一 些 其 他 工作 ， 尤 其 是 对 集合 进行 操作 ， 因 为 处 理 对 象 组 是 非常 简单 的 ， 不 需要 对 对 象 类 型 进行 任 
何 假设 ， 这 是 为 什么 存在 本 章 前 和 面 介绍 的 泛 型 集合 类 的 一 个 原因 。 

男 一 个 需要 注意 的 限制 是 ， 在 比较 为 泛 型 类 型 提供 的 类 型 值 和 null 时 ， 只 能 使 用 运算 竺 一 或 !=。 例 如 ， 下 
面 的 代码 会 正常 工作 ; 


public bool Compare(Tl opl, T1 op2) 


{ 
if (opl != null && op2 != null) 
{ 
return true; 
} 
else 
return false; 
} 
} 


其 中 ， 如 果 了 TI 是 一 个 人 类 型 ， 则 总 是 假定 它 是 非 空 的 ， 于 是 在 上 面 的 代码 中 ，Compare 总 是 返回 true. fH 
是 ， 下 面试 图 比较 两 个 实 参 opl 和 op2 的 代码 将 不 能 编译 : 


public bool Compare(T1 opl, T1 op2) 


{ 
if (opl == op2) 
{ 
return true; 
else 
return false; 
} 
} 


其 原因 是 这 段 代码 假定 Tl 文 持 一 运算 待 。 这 说 明 ， 要 对 这 型 执行 实际 操作 ， 需 要 更 多 地 了 解 类 中 使 用 的 
类 型 。 
1. default 关键 字 
要 确定 用 于 创建 沁 型 类 实例 的 类 型 ， 需 要 了 解 一 个 最 基本 的 情况 : ENE S| ARERR. HT AD 
这 个 情况 ， 束 不 能 用 下 面 的 代码 赋予 null 值 : 
public MyGenericClass () 


innerT1Object = null; 
} 


如 果 T1 是 值 类 型 ， 则 innerTlObject 不 能 取 null 值 ， 所 以 这 段 代码 不 会 编译 。 辛 好 ， 开 发 人 员 考 虑 到 了 这 
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个 问题 ， 使 用 default 关键 字 (本 书 前 面 在 switch 结构 中 用 过 它 ) 的 新 用 法 解决 了 它 。 这 个 新 用 法 如 下 : 
public MyGenericClass () 
innerTlObject = default (T1); 
} 
其 结果 是 ， 如 果 innerT1Object 是 引用 类 型 ， 就 给 它 赋 了 予 null A; 如 果 它 是 值 尖 型 ， 束 给 它 赋 予 默认 值 。 对 
于 数字 类 型 ， 这 个 默认 值 是 0; 而 结构 根据 其 各 个 成 员 的 类 型 ， 以 相同 的 方式 初始 化 为 0 或 null. default 关键 
字 人 允许 对 必须 使 用 的 类 型 执行 更 多 操作 ， 但 为 了 更 进一步 ， 还 需要 限制 所 提供 的 类 型 。 
2. 约束 类 型 
前 面 用 于 泛 型 类 的 类 型 称 为 无 绑 定 (nbounded) 类 型 ， 因 为 没有 对 它们 进行 任何 约束 。 而 通过 约束 
(constraining) 类 型 ， 可 以 限制 用 于 实例 化 泛 型 类 的 类 型 ， 这 有 许多 方式 。 例 如 ， 可 以 把 类 型 限制 为 继承 自 某 个 
类 型 。 回 顾 前 面 使 用 的 Animal. Cow 和 Chicken 类 ， 可 以 把 一 个 类 型 限制 为 Animal 或 继承 日 Animal， 则 下 面 
的 代码 是 正确 的 : 
MyGenericClass<Cow> = new MyGenericClass<Cow>(); 
但 下 面 的 代码 不 能 编 详 : 
MyGenericClass<string> = new MyGenericClass<string>(); 
在 类 定义 中 ， 这 可 以 使 用 where 关键 字 来 实现 : 
class MyGenericClass<T> where T : constraint { ... } 
其 中 constraint ;E X. SAR. HVAT ERE BAR, PAD ZI) A S 7T: 
class MyGenericClass«T» where T : constrainti, constraint2 [| ... } 
还 可 以 使 用 多 个 where 语句 ， 定 义 泛 型 类 需要 的 任意 类 型 或 所 有 类 型 上 的 约束 : 


class MyGenericClass<Tl, T2» where T1 : constrainti where T2 : constraint2 


TU 
约束 必须 出 现在 继承 说 明 符 的 后 面 : 


class MyGenericClass<Tl, T2> : MyBaseClass, IMyInterface 
where Tl : constraintl where T2 : constraint? { ... } 


# 12-3 中 列 出 了 一 些 可 用 的 约束 。 


表 12-3 FARAR 


E. EEL 


struct 类 型 必须 是 值 类 型 在 类 中 ， 需 要 值 类 型 才能 起 作用 ,例如 ,TT 类 型 的 成 员 变 量 是 0， 表示 
ARA X. 
class 类 型 必须 是 引用 类 型 在 类 中 ， 需 要 引用 类 型 才能 起 作用 ， 例 如 ，T 类 型 的 成 员 变 量 是 null, 
base- class | 类 型 必须 是 基 类 或 继承 目 基 类 。 可 以 根 | 在 类 中 ， 需 要 继承 目 基 类 的 茶 种 基本 功能 ， 才 能 起 作用 
据 这 个 约束 提供 任意 类 名 
interface 类 型 必须 是 接口 或 实现 了 接口 在 关中， 需要 接口 公开 的 茶 种 基本 功能 ， 才 能 起 作用 
new() 类 型 必须 有 一 个 公共 的 无 参 构造 函数 在 类 中 ， 需 要 能 实例 化 T 类 型 的 变量 ， 例 如 在 构造 函数 中 实例 化 


注意 : 


如 果 newO 用 作 约 束 ， 它 就 必须 是 为 类 型 指定 的 最 后 一 个 约束 。 
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可 通过 base-class 约束 ， 把 一 个 类 型 参数 用 作 另 一 个 类 型 参数 的 约束 ， 如 下 所 示 : 

class MyGenericClass<Tl, T2» where T2 : T1 { ... } 

其 中 ，T2 必须 与 Tl 的 类 型 相同 ， 或 者 继承 目 T1。 这 称 为 裸 类 型 约束 naked type constraint), ézR— 4 iz. 
型 类 型 参数 用 作 男 一 个 类 型 参数 的 约束 。 

类 型 约束 不 能 循环 ， 例 如 : 


class MyGenericClass<Tl, T2» where T2 : Tl where T1 : T2 [| ... } 
这 段 代码 不 能 编译 。 下 面 的 示例 将 定义 和 使 用 一 个 泛 型 类 ， 该 类 使 用 前 面 几 章 介 绍 的 Animal 类 系列 。 
试 一 试 ”定义 泛 型 类 : Ch12Ex04 


(1) 在 C:\BeginningCSharp7\Chapter12 目录 中 创建 一 个 新 的 控制 台 应 用 程 订 Ch12Ex04。 

(2) 在 Solution Explorer 窗口 中 右 击 项 目 名 称 ， 选 择 Add Existing Item 选项 。 

(3) 从 Ci\BegVCSharp\Chapter12\Ch12Ex02 目录 中 选择 Animal.cs、Cow.cs 和 Chicken.cs 文件 ， 单 击 Add 按钮 。 
(4) 在 已 经 添加 的 文件 中 修改 名 称 空间 声明 ， 如 下 所 示 : 


namespace Ch12Ex04 


public abstract class Animal 
{ 


public abstract void MakeANoise(); 
} 


(6) 修改 Chicken.cs, ll Fr: 


public class Chicken : Animal 


{ 
public override void MakeANoise() 
{ 
WriteLine ($"{name} says 'cluck!';"); 
} 


} 
(7) 修改 Cow.cs， 如 下 所 示 : 


Public class Cow : Animal 


{ 
pem override void MakeANoise() 
i WriteLine ($"{name} says 'moo!'"); 
i } 


(8) 添加 一 个 新 类 SuperCow， 并 修改 SuperCow.cs 中 的 代码 ， 如 下 所 示 : 


public class SuperCow : Cow 


{ 
public void Fly() 
{ 
WriteLine ($"{name} is flying!"); 
} 
public SuperCow(string newName): base (newName) 
{ 
} 
public override void MakeANoise () 
{ 
WriteLine ( 
S"{name} says 'here I come to save the day!'"); 
} 
} 


(9) 添加 一 个 新 类 Farm, 并 修改 Farm.cs 中 的 代码 ， 如 下 所 示 : 


using System; 
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using System.Collections; 
using System.Collections.Generic; 
using System.Ling; 
using System.Text; 
using System. Threading. Tasks; 
namespace Ch12Ex04 
{ 
public class Farm<T> : IEnumerable<T> 
where T : Animal 
{ 
private List<T> animals = new List<T>(); 
public List<T> Animals 
{ 
get { return animals; } 
} 
public IEnumerator<T> GetEnumerator() => animals.GetEnumerator (); 
IEnumerator IEnumerable.GetEnumerator() => animals.GetEnumerator (); 
public void MakeNoises () 
{ 
foreach (T animal in animals) 
{ 
animal .MakeANoise (); 
} 
} 
public void FeedTheAnimals () 
{ 
foreach (T animal in animals) 
{ 
animal .Feed(); 
} 
} 
public Farm<Cow> GetCows () 
{ 
Farm<Cow> cowFarm = new Farm«Cow»(); 
foreach (T animal in animals) 
{ 
if (animal is Cow) 
{ 
cowFarm.Animals.Add(animal as Cow); 
) 
} 


return cowFarm; 


} 
(10) 修改 Program.cs, Al Fr: 


static void Main(string[] args) 

{ 
Farm<Animal> farm = new Farm<Animal>() ; 
farm.Animals.Add(new Cow("Rual")); 
farm.Animals.Add(new Chicken("Donna")); 
farm.Animals.Add(new Chicken("Mary")); 
farm.Animals.Add(new SuperCow("Ben")); 
farm.MakeNoises(); 
Farm<Cow> dairyFarm = farm.GetCows (); 
dairyFarm.FeedTheAnimals (); 
foreach (Cow cow in dairyFarm) 


i 


if (cow is SuperCow) 
1 
(cow as Supercow) .Fly(); 
) 
) 
ReadKey () ; 
} 


(11) 执行 该 应 用 程序 ， 结 果 如 图 12-5 所 示 。 
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示例 说 明 
在 这 个 示例 中 , 创建 了 一 个 泛 型 类 Farm<T>, 它 没有 继承 泛 型 List 类 , 而 将 泛 型 List 类 作为 公共 属性 公开 ， 


i List 的 类 型 由 传递 给 Farm<T> 的 类 型 参数 工 确定 ， 且 被 约束 为 Animal， 或 者 继承 日 Animal. 


public class Farm<T> : IEnumerable<T> 
where T : Animal 


{ 


private List<T> animals = new List<T>(); 
public List<T> Animals 
{ 


get { return animals; } 


} 


Farm<T> 还 实现 了 IEnumerable<T>, HF, T fexéziix Piz Re, ACHE DIR ET f 293m. SC 
Wik Se, REA, WATE TE FarmcT-'P INI, AN ae UTR Farm<T>.Animals. (RA S BE ICE XX — £3 
只 需要 返回 Animals 公开 的 枚 举 器 即 可 ， 该 枚 举 器 是 一 个 List<T> 类 ， 该 类 也 实现 了 IEnumerable<T>。 


public IEnumerator<T> GetEnumerator() => animals.GetEnumerator(); 
AVA IEnumerable<T>4#7K F1 IEnumerable， 所 以 还 需要 实现 IEnumerable.GetEnumerator (): 
IEnumerator IEnumerable.GetEnumerator() => animals.GetEnumerator(); 


之 后 ，Farm<T> 包 含 的 两 个 方法 利用 了 抽象 类 Animal 的 方法 : 


public void MakeNoises ( ) 


{ 
foreach (T animal in animals) 
{ 
animal .MakeANoise(); 
} 
} 
public void FeedTheAnimals () 
{ 
foreach (T animal in animals) 
{ 
animal.Feed(); 
} 
} 


T 被 约束 为 Animal, 所 以 这 段 代码 会 正确 编译 一 一 无 论 工 实际 上 是 什么 , 都 可 以 访问 MakeANoise0 和 Feed() 


下 一 个 方法 GetCows0 更 有 趣 。 这 个 方法 提取 了 集合 中 类 型 为 Cow( 或 继承 目 Cow， 例 如 ， 新 的 SuperCow 
类 ) 的 所 有 项 : 
public Farm<Cow> GetCows () 


{ 


Farm<Cow> cowFarm = new Farm<Cow>(); 
foreach (T animal in animals) 


{ 
if (animal is Cow) 
{ 
cowFarm.Animals.Add(animal as Cow); 
} 
} 


return cowFarm; 
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有 趣 的 是 ， 这 个 方法 似乎 有 点 浪费 。 如 果 以 后 希望 有 同一 系列 的 其 他 方法 ， 如 GetChickens0， 也 需要 显 式 实现 
它们 。 在 使 用 许多 类 型 的 系统 中 ， 需 要 更 多 方法 。 一 个 较 好 的 解决 方案 是 使 用 泛 型 方法 ， 详 见 本 章 后 面 的 内 容 。 

Program.cs 中 的 客户 代码 测试 了 Farm 的 各 个 方法 ， 它 包含 的 代码 大 多 已 在 前 面 列 出 ， 所 以 不 需要 再 深入 探 
讨 这 些 代 码 。 

3. 从 泛 型 类 中 继承 

上 例 中 的 Brm<T> 类 以 及 本 章 前 面 介绍 的 其 他 几 个 类 都 继承 自 一 个 泛 型 类 型 。 在 Farm<T> 中 ， 这 个 类 型 是 
一 个 接口 在 numerable<T>。 这 里 Farm<T> 在 T 上 提供 的 约束 也 会 在 IEnumerable<T> 中 使 用 的 工 上 添加 一 个 额 
外 的 约束 。 这 可 以 用 于 限制 未 约束 的 类 型 ， 但 需要 遵循 一 些 规则 。 

首先 ， 如 果 某 个 类 型 所 继承 的 基 类 型 中 受到 了 约束 ， 该 类 型 就 不 能 “解除 约束 ”。 也 就 是 说 ， 类 型 T 在 所 
继承 的 基 类 型 中 使 用 时 ， 该 类 型 必须 受到 至 少 与 基 类 型 相同 的 约束 。 例 如 ， 下 面 的 代码 是 正确 的 : 


class SuperFarm<T> : Farm<T> 
where T : SuperCow {} 


AVA T É Farm<T> 中 被 约束 为 Animal, {EC AGRA SuperCow, Ma T ARAKI TPS, A 
这 是 可 行 的 。 但 是 ， 以 下 代码 不 会 编 详 : 


class SuperFarm<T> : Farm<T> 
where T : struct{} 


可 以 肯定 地 讲 ， 提 供给 SuperFarm<T> 的 类 型 不 能 转换 为 可 由 Farm<T> 使 用 的 T， 所 以 代码 无 法 编 详 。 
甚至 对 于 约束 为 超 集 的 情况 ， 也 会 出 现 相同 的 问题 : 


class SuperFarm<T> : Farm<T> 
where T : classi] 


即使 SuperFarm<T> 人 允许 存在 像 Animal 这 样 的 类 型 ，Farm<T> 中 也 不 允许 有 满足 类 约束 的 其 他 类 型 。 否 则 
编译 束 会 失败 。 这 个 规则 适用 于 本 章 前 和 面 介绍 的 所 有 约束 类 型 。 

另外 ， 如 果 继 承 自 一 个 汉 型 类 型 ， 就 必须 提供 所 有 必需 的 类 型 信息 ， 这 可 以 使 用 其 他 泛 型 类 型 参数 的 形式 
来 提供 ， 如 上 所 述 ， 也 可 以 显 式 提供 。 这 也 适用 于 继承 了 泛 型 类 型 的 非 泛 型 类 。 例 如 : 

public class Cards : List<Card>, ICloneable(] 

这 是 可 行 的 ， 但 下 面 的 代码 会 失败 : 

public class Cards : List<T>, ICloneable{ } 

因为 没有 提供 工 的 信息 ， 所 以 无 法 编 详 。 

注意 : 

如 果 给 泛 型 类 型 提供 了 参数 , 例如 ,上面 的 List<Card>, 就 可 以 称 该 类 型 是 “关闭 的 ”。 同样 , 继承 List<T>， 
就 是 继承 一 个 “打开 ”的 泛 型 类 型 。 

4. 泛 型 运算 符 

在 C# 中 ,可 以 像 其 他 方法 一 样 进行 运算 符 的 重 写 ， 也 可 以 在 泛 型 类 中 实现 此 类 重 写 。 例如， 可 在 Farm<T> 
中 定义 如 下 隐 式 的 转换 运算 符 : 

public static implicit operator List<Animal>(Farm<T> farm) 


List<Animal> result = new List<Animal>(); 
foreach (T animal in farm) 


result.Add(animal); 


return result; 


} 
这 样 ， 如 有 必要 ， 就 可 以 在 Farm<T> 中 把 Animal 对 象 直接 作为 List<Animal> 来 访问 。 例 如 ， 使 用 下 面 的 
运算 符 添 加 两 个 Farm<T> 实 例 ， 这 是 很 方便 的 : 
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public static Farm<T> operator +(Farm<T> farml, List<T> farm2) 
Farm<T> result = new Farm<T>(); 

foreach (T animal in farml) 

; result.Animals.Add (animal); 

— (T animal in farm2) 

à; if (!result.Animals.Contains (animal) ) 


{ 


} 
} 
return result; 
} 
public static Farm<T> operator +(List<T> farml, Farm<T> farm2) 
=> farm? + farml; 


result.Animals.Add (animal); 


接 看 可 以 添加 Farm<Animal> 和 Farm<Cow> 的 实例 ， 如 下 所 示 : 


Farm<Animal> newFarm = farm + dairyFarm; 


在 这 行 代码 中 ，dairyFarm(Farm<Cow> 的 实例 ) 隐 式 转 换 为 List<Animal>，List<Animal> 可 在 Farm<T> 中 由 
读者 可 能 认为 ， 使 用 下 面 的 代码 也 可 以 做 到 这 一 点 : 


public static Farm<T> operator +(Farm<T> farml, Farm<T> farm2){ ... } 


日 是 ，Farm<Cow> 不 能 转换 为 Farm<Animal>， 所 以 汇总 会 失败 。 为 了 更 进一步 ， 可 以 使 用 下 面 的 转换 运 
{Azt, Farm<Cow>4 
算 和 从 来 解决 这 个 问题 : 
public static implicit operator Farm<Animal>(Farm<T> farm) 
{ 
Farm «Animal» result = new Farm <Animal>(); 
foreach (T animal in farm) 
{ 


result.Animals.Add(animal); 


] 


return result; 
} 
使 用 这 个 运算 符 ，Farm<T> 的 实例 (如 Farm<Cow>) 就 可 以 转换 为 Farm<Animal> 的 实例 , 这 解决 了 上 面 的 问 
题 。 所 以 ， 可 以 使 用 上 面 列 出 的 两 种 方法 中 的 一 种 ， 但 是 后 者 更 适合 ， 因 为 它 比 较 人 简单 。 


5. 泛 型 结构 


前 几 章 说 过 ， 结 构 实际 上 与 类 相同 ， 只 有 一 些微 小 区 别 ， 而 且 结 构 是 值 类 型 ， 不 是 引用 类 型 。 所 以 ， 可 以 
用 与 泛 型 类 相同 的 方式 来 创建 泛 型 结构 。 例 如 : 

public struct MyStruct<Tl, T2» 

i public T1 iteml; 


public T2 item2; 
} 


12.320 ”定义 泛 型 接口 


前 面 介 绍 了 几 个 泛 型 接口 ， 它 们 都 位 于 Systems.Collections.Generic 名 称 空间 中 ， 例 如 ， 上 一 个 示例 中 使 用 
的 下 nu0merable<T>。 定 义 泛 型 接口 与 定义 泛 型 类 所 用 的 搁 术 相同 ， 例 如 : 


interface MyFarmingInterface<T> 
where T : Animal 


bool AttemptToBreed(T animall, T animal2); 
T OldestInHerd { get; } 
} 


Hop, 1278223 T HIE AttemptIoBreed0 的 两 个 实 参 的 类 型 和 OldestInHerd 属性 的 类 型 。 
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其 继承 规则 与 类 相同 。 如 果 继 承 了 一 个 基 泛 型 接口 ， 就 必须 遵循 这 些 规则 ， 例 如 保持 基 接口 泛 型 类 型 参数 
的 约束 。 


12.3.3 ”定义 泛 型 方法 


上 个 示例 中 使 用 了 方法 GetCowsO。 在 讨论 这 个 示例 时 也 提 到 ， 可 以 使 用 泛 型 方法 得 到 这 个 方法 的 更 一 般 
形式 。 本 市 将 说 明 如 何 实 现 这 一 目标 。 在 沁 型 方法 中 ， 返 回 类 型 和 /或 参数 类 型 由 沁 型 类 型 参数 来 确定 。 例 如 : 


public T GetDefault<T>() => default(T); 


这 个 小 示例 使 用 本 章 前 面 介 绍 的 default 关键 字 ， 为 类 型 工 返回 默认 值 。 对 这 个 方法 的 调用 如 下 所 示 : 
int myDefaultInt = GetDefault<int>(); 

在 调用 该 方法 时 提供 了 类 型 参数 T。 

这 个 工 与 用 于 给 关 提 供 记 型 类 型 参数 的 类 型 差异 极 大 。 实 际 上 ， 可 以 通过 非 泛 型 类 来 实现 这 型 方法 : 


public class Defaulter 
{ 

public T GetDefault<T>() => default(T); 
} 


但 如 果 类 是 泛 型 的 ， 就 必须 为 泛 型 方法 类 型 使 用 不 同 的 标识 从 。 下 面 的 代码 不 会 编 详 : 
public class Defaulter<T> 


{ 
public T GetDefault<T>() => default(T); 


必须 重 命名 方法 或 类 使 用 的 类 型 T。 
泛 型 方法 参数 可 以 采用 与 类 相同 的 方式 使 用 约束 ， 在 此 可 以 使 用 任意 的 类 类 型 参数 ， 例 如 : 


public class Defaulter«T1» 
{ 
public T2 GetDefault<T2>() 
where T2 : Tl 
i 
return default (T2); 
} 
} 


其 中 ， 为 方法 提供 的 类 型 T2 必须 与 给 类 提供 的 T1 相同， 或 者 继承 自 T1。 这 是 约束 泛 型 方法 的 常用 方式 。 
在 前 面 的 Farm<T> 类 中 ， 可 以 包含 下 面 的 方法 (在 Ch12Ex04 的 下 载 代码 中 包含 它们 ， 但 已 注释 掉 )。 


public Farm<U> GetSpecies<U>() where U : T 
{ 
Farm<U> speciesFarm = new Farm<U>(); 
foreach (T animal in animals) 
{ 
if (animal is U) 
{ 
speciesFarm.Animals.Add(animal as U); 
} 
} 


return speciesFarm; 
} 
这 可 以 蔡 代 GetCows0 和 相同 类 型 的 其 他 方法 。 这 里 使 用 的 汉 型 类 型 参数 U h TR, TXH Farm<T> 关 
约束 为 Animal。 因 此 ， 如 宁愿 意 ， 可 以 把 工 的 实例 视 为 Animal 的 实例 。 
在 Ch12Ex04 的 客户 端 代码 Program.cs 中 ， 使 用 这 个 新 方法 需要 进行 一 处 修改 : 
Farm<Cow> dairyFarm = farm.GetSpecies<Cow>(); 
也 可 以 编写 如 下 代码 : 


Farm<Chicken> poultryFarm = farm.GetSpecies<Chicken>(); 


对 于 继承 日 Animal 的 其 他 类 ， 都 可 以 使 用 这 种 方法 。 
这 里 要 注意 ， 如 果菜 个 方法 有 沁 型 类 型 参数 ， 会 改变 该 方法 的 签名 。 也 了 就 是 说 ,该 方法 有 几 个 重 载 版 
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本 ， 它 们 仅 在 泛 型 类 型 参数 上 有 区 别 。 例 如 : 


public void ProcessT<T>(T opl){ ... } 
public void ProcessT«T, U>(T opl){ ... } 


TE FH ATI R F Wad FS JANE E WZ 78 20 AI PBL 
1234 ”定义 泛 型 委托 

最 后 一 个 要 介绍 的 沁 型 类 型 是 沁 型 委托 。 本 章 前 面 在 介绍 如 何 排序 和 搜索 沁 型 列表 时 置 介 绍 过 它们 ， 即 分 
别 为 此 使 用 了 Comparison<T> 和 Predicate<T> 委 托 。 

第 6 章 介 绍 了 如 何 使 用 方法 的 参数 和 返回 类 型 、delegate 关键 

public delegate int MyDelegate (int opl, int op2); 

BE UZMAE, H mAH ARENEKS, PO: 

public delegate T1 MyDelegate«T1, T2>(T2 opl, T2 op2) where T1: T2; 

可 以 看 出 ， 也 可 以 在 这 里 使 用 约束 。 第 13 章 将 更 详细 地 介绍 委托 ， 了 解 在 种 见 的 C# 纲 程 技术 ( 即 “ 事 件 ”) 
中 如 何 使 用 它们 。 


字 和 委托 名 来 定义 委托 ， 例 如 : 


12.4 24k 


变 体 (variance) 是 协 变 (covariance] 和 抗 变 (contravariance) 的 统称 ， 这 两 个 概念 在 NET 4 中 引入 。 实 际 上 ， 它 
们 已 经 存在 了 较 长 时 间 了 (在 NET 2.0 中 就 可 以 使 用 )， 但 在 NET 4 之 前 很 难 实现 它们 ， 因 为 它们 需要 定制 的 编 

要 掌握 这 些 木 语 的 含义 ， 最 简单 的 方式 是 把 它们 与 多 态 性 进行 比较 。 多 态 性 允许 把 派生 类 型 的 对 象 放 在 基 
类 型 的 变量 中 ， 例 如 


Cow myCow = new Cow("Ben"); 
Animal myAnimal = myCow; 


其 中 把 Cow 类 型 的 对 象 放 在 Animal 类 型 的 变量 中 ， 这 是 可 行 的 ， 因 为 Cow JK/E E] Animal. 
但 这 不 适用 于 接口 ， 也 就 是 说 ， 下 面 的 代码 不 能 工作 : 


IMethaneProducer<Cow> cowMethaneProducer = myCow; 
IMethaneProducer«Animal» animalMethaneProducer = cowMethaneProducer; 


假定 Cow 文 持 IMethaneProducer<Cow> 接 口 ， 第 一 行 代码 就 没有 问题 。 但 是 ， 弟 二 行 代码 预先 假定 两 个 接 
口 类 型 有 某 种 关系 ， 但 实际 上 这 种 关系 不 存在 ， 所 以 无 法 把 一 种 类 型 转换 为 男 一 种 类 型 。 是 这 样 吗 ? 使 用 本 章 
前 面 介 绍 的 技术 肯定 不 行 ， 因 为 泛 型 类 型 的 所 有 类 型 参数 部 是 不 变 的 。 但 可 以 在 泛 型 接口 和 泛 型 委托 上 定义 变 
体 类 型 参数 ， 以 适合 上 述 代码 演示 的 情形 。 

为 使 上 述 代码 工作 ，IMethaneProducer<T> 接 口 的 类 型 参数 工 必须 是 协 变 的 。 有 了 协 变 的 类 型 参数 ， 就 可 以 
在 IMethaneProducer<Cow> 和 IMethaneProducer<Animal> 之 则 建立 继承 关系 ， 这 样 一 种 类 型 的 变量 就 可 以 包含 
男 一 种 类 型 的 什 ， 这 与 多 态 性 类 似 (但 稍 复杂 些 )。 

为 了 完成 对 变 体 的 介绍 ， 需 要 看 看 变 体 的 另 一 面 : 抗 变 。 抗 变 和 协 变 是 类 似 的 ， 但 方 回 相反 。 抗 变 不 能 像 
协 变 那样 ， 把 泛 型 接口 值 放 在 使 用 基 类 型 的 变量 中 ， 但 可 以 把 该 接口 放 在 使 用 派生 类 型 的 变量 中 ， 例 如 : 


IGrassMuncher<Cow> cowGrassMuncher = myCow; 
IGrassMuncher«SuperCow» superCowGrassMuncher = cowGrassMuncher; 


初 看 起 来 似乎 有 点 古怪 ， 因 为 不 能 通过 多 态 性 完成 相同 的 功能 。 但 是 这 在 一 些 情况 下 是 一 项 有 效 的 拉 术 ， 
如 “ 抗 变 ”一 节 中 所 述 。 
接 下 来 的 两 节 将 介绍 如 何在 泛 型 类 型 中 实现 变 体 ， 以 及 .NET Framework 如 何 使 用 变 体 简化 编程 。 
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注意 : 


本 节 所 有 代码 都 包 念 在 演示 项 目 VarianceDemo 中 ， 可 供 使 用 


12.4.1 协 变 
要 把 泛 型 类 型 参数 定义 为 协 变 ， 可 在 类 型 定义 中 使 用 out 关键 字 ， 如 下 面 的 示例 所 示 : 


public interface IMethaneProducer<out T>{ ... } 


对 于 接口 定义 ， 协 变 类 型 参数 只 能 用 作 方 法 的 返回 值 或 属性 get 7; |n] $5 - 
说 明 协 变 用 途 的 一 个 很 好 例子 在 .NET Framework 中 ， 即 前 面 使 用 的 IEnumerable<T> 接 口 。 在 这 个 接口 中 ， 项 类 
型 工 定 义 为 协 变 ， 这 表示 可 以 把 文 持 IEnumerable<Cow> 的 对 象 放 在 IEnumerable<Animal> 类 型 的 变量 中 。 
因此 下 面 的 代码 是 有 效 的 : 
static void Main(string[] args) 
{ 
List<Cow> cows = new List<Cow>(); 
cows.Add(new Cow("Rual")); 
cows.Add(new SuperCow("Donna"));: 
ListAnimals (cows); 
ReadkKey () ; 
} 


static void ListAnimals (IEnumerable<Animal> animals) 


foreach (Animal animal in animals) 
{ 
WriteLine (animal.ToString()); 
} 
} 


其 中 cows 变量 的 类 型 是 List<Cow>, "E x4 下 numerable<Cow> 接 口 。 通 过 协 变 ， 可 以 将 这 个 变量 传递 给 
fi 下 numerable<Animal> 类 型 的 参数 的 方法 。 回 顾 一 下 foreach 循环 的 工作 方式 ， 束 知道 GetEnumerator0 方 法 
用 于 获取 IEnumerator-T^11]—/ 82848, BAS ASIN Current 属性 用 于 访问 项 。IEnumerator<T> 还 将 其 类 型 参数 
定义 为 协 变 ， 这 表示 可 以 把 它 用 作 参 数 的 get 访问 右 ， 而 且 一 切 部 运转 民 好 。 


1242 mse 
要 把 沁 型 类 型 参数 定义 为 抗 变 ， 可 在 类 型 定义 中 使 用 in KEES: 


public interface IGrassMuncher<in T>{ ... } 


对 于 接口 定义 ， 抗 变 类 型 参数 只 能 用 作 方 法 参数 ， 不 能 用 作 返 回 类 型 。 

理解 这 一 点 的 最 佳 方式 是 列举 一 个 在 .NET Framework 中 使 用 抗 变 的 例子 。 带 有 抗 变 类 型 参数 的 一 个 接口 是 
表面 用 过 的 IComparer<T=>。 可 以 给 Animal 实现 这 个 接口 ， 如 下 所 示 : 

public class AnimalNameLengthComparer : IComparer<Animal> 

public int Compare(Animal x, Animal y) 


=> x.Name.Length.CompareTo (y.Name.Length) ; 

} 

这 个 比较 器 按 名 称 的 长 度 比 较 动 物 ， 所 以 可 使 用 它 对 List<Animal> 的 实例 排序 。 通 过 抗 变 ， 还 可 以 使 用 它 
对 List<Cow> 的 实例 排序 ， 尽 管 List<Cow>.Sort() 7; i2; 需要 IComparer<C ow 二 的 实例 。 

List<Cow> cows = new List<Cow>(); 

cows.Add(new Cow("Rual")); 

cows.Add(new Supercow ("Donna") ); 

cows.Add(new Cow("Mary")); 

cows.Add(new Cow("Ben")); 

cows.Sort (new AnimalNameLengthComparer ()); 


大 多 数 情况 下 , 抗 变 都 会 发 生 一 一 它 被 添加 到 .NET Framework 中 就 是 为 了 帮助 执行 这 种 操作 。.NET 4 及 更 
蜗 版 本 中 这 两 种 变 体 的 优点 是 ， 可 以 在 需要 时 使 用 本 节 介 绍 的 技术 实现 它们 。 
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125 ”习题 


(1) 下 面 哪些 元 率 可 以 是 泛 型 ? 
b. 方法 
c. 属性 
d. ia LEEREN, 
e. 结构 
f. 枚 举 
(2) 扩展 Ch12Ex01 中 的 Vector 类 ， 使 * 运 算 行 返回 两 个 矢量 的 点 积 (dot product). 


注意 : 


两 个 矢量 的 点 积 定义 为 两 个 矢量 的 大 小 与 两 个 矢量 之 间 夹 角 余 弦 的 来 积 。 
(3) 下 面 的 代码 存在 什么 错误 ? 请 加 以 修改 。 


public class Instantiator<T> 
{ 

public T instance; 

public Instantiator () 

{ 

instance = new T(); 

} 

} 


(4) 下 面 的 代码 存在 什么 错误 ? 请 加 以 修改 。 
public class StringGetter<T> 
{ 


public string GetString<T>(T item) => item.ToString(); 
} 


(S) 创建 一 个 泛 型 类 ShortList<T>， 它 实现 了 IList<T>， 包 含 一 个 项 集合 及 集合 的 最 大 容量 。 这 个 最 大 容量 
应 是 一 个 整数 ， 并 可 以 提供 给 ShortList<T> 的 构造 国 效 ， 或 者 默认 为 10。 构 造 函 数 还 应 通过 IEnumerable<T> 参 
数 获 取 项 的 最 初 列 表 。 该 类 与 List<T> 的 功能 相同 ， 但 如 果 试 图 给 集合 添加 太 多 的 项 ， 或 者 传递 给 构造 函数 的 
IEnumerable<T> 包 含 太 多 的 项 ， 就 会 抛 出 IndexOutOfRangeException 类 型 的 异 剃 。 

(6) 下 面 的 代码 可 以 进行 编译 吗 ? 如 果 不 能 ， 试 说 明 原 因 。 

public interface IMethaneProducer<out T> 

| void BelchAt(T target); 

附录 A 给 出 了 习题 答案 。 


126 “本章 要 点 


E a 要 A 
泛 型 类 型 需要 一 个 或 多 个 类 型 参数 才能 工作 。 在 声明 变量 时 ， 传 递 需要 的 类 型 参数 ， 就 可 以 把 泛 型 类 型 用 作 变 


BE | 量 的 类 型 。 为 此 ， 应 把 去 号 分 隔 的 类 型 名 列表 放 在 尖 括 号 中 
可 空 类 型 可 空 类 型 可 使 用 指定 值 类 型 的 任意 值 或 Aul 值 。 使 用 Nullable<T 或 也 语法 ， 可 以 声明 可 空 类 型 的 变量 
m 空 接合 运算 符 返回 第 一 个 操作 数 的 值 ， 如 果 第 一 个 操作 数 是 mull， 就 返回 第 二 个 操作 数 的 值 

泛 型 集合 非常 有 用 ， 因 为 它们 内 置 了 强 类 型 化 功能 。 可 使 用 List<T>、Collection<T> 和 Dictionary<K, V> 等 集合 
泛 型 集合 类 型 ， 它 们 还 提供 了 泛 型 接口 。 为 了 针对 泛 型 集合 进行 排序 和 搜索 ， 应 使 用 IComparer-T» Rl IComparable<T> 


接口 


E€ a 


定义 泛 型 类 


泛 型 类 型 的 参 


BAR 


其 他 泛 型 类 型 


变 体 
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( 续 表 ) 

要 A 
泛 型 类 型 的 定义 十 分 类 似 于 其 他 类 型 ， 但 在 指定 类 型 名 时 需要 添加 泛 型 类 型 参数 。 与 使 用 泛 型 类 型 一 样 ， 也 需 
要 把 这 些 参 数 指定 为 逗号 分 隔 的 列表 ， 并 放 在 尖 括 号 中 。 在 使 用 类 型 名 的 地 方 都 可 以 使 用 泛 型 类 型 参数 ， 例 如 
可 在 方法 的 返回 值 和 参数 中 使 用 它们 
为 高 效 地 在 泛 型 类 型 代码 中 使 用 泛 型 类 型 参数 ， 可 以 在 使 用 类 型 时 约束 可 以 提供 的 类 型 。 可 以 根据 基 类 、 所 文 
持 的 接口 、 是 否 必须 是 值 类 型 或 引用 类 型 以 及 是 否 支 持 无 参数 的 构造 函数 等 ， 来 约束 类 型 参数 。 如 果 没 有 这 些 
约束 ， 就 必须 使 用 default 关键 字 来 实例 化 泛 型 类 型 的 变量 
除 类 之 外 ， 还 可 以 定义 泛 型 接口 、 委 托 和 方法 
变 体 是 类 似 于 多 态 性 的 一 个 概念 ， 但 应 用 于 类 型 参数 。 它 允许 使 用 一 个 泛 型 类 型 替代 另 一 个 泛 型 类 型 ， 这 些 泛 
型 类 型 仅 在 所 使 用 的 泛 型 类 型 参数 上 有 区 别 。 协 变 允许 在 两 种 类 型 之 间 转 换 ， 其 中 目标 类 型 有 一 个 类 型 参数 ， 
它 是 源 类 型 的 类 型 参数 的 基 类 。 抗 变 允许 进行 相反 的 转换 。 协 变 类 型 参数 用 out 参数 定义 ， 只 能 用 作 返 回 类 型 
和 属性 get 访问 器 的 类 型 。 抗 变 类 型 参数 用 in 参数 定义 ， 只 能 用 作 方 法 的 参数 


PTS 


高 级 CHEEK 


KBAR: 

dedi 

全 局 名 称 空 间 限 定 符 
创建 定制 异常 

使 用 事件 

使 用 匿名 方法 

使 用 C# 特 性 

使 用 初始 化 器 

使 用 var 类 型 和 类 型 推理 
如 何 使 用 匿名 类 型 
如 何 使 用 dynamic 类 型 
如 何 使 用 命名 和 可 选 的 方法 参数 
使 用 Lambda 表达 式 


本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapterl3 文件 夹 中 并 已 根据 本 草 示 例 的 
名 称 单独 命名 。 


本 章 将 介绍 前 面 未 涉及 的 内 容 ， 继 续 讨论 C# 语 言 中 不 适合 放 在 其 他 地 方 讨论 的 内 容 。C# 的 发 明 者 Anders 
Hejlsberg 和 微软 公司 的 其 他 人 一 直 在 更 新 和 改进 该 语言 。 在 撰写 本 书 时 ， 最 新 的 改进 都 放 在 C# 语 言 的 第 7 版 
中 ， 它 与 NET4.7 都 作为 Visual Studio 2017 系列 产品 的 一 部 分 发 布 。 阅 读 了 本 书 前 面 的 内 容 后 ， 读 者 可 能 会 考 
虑 还 需要 什么 其 他 功能 。 实 际 上 ，c# 以 前 的 版 本 从 功能 的 角度 来 看 并 不 缺乏 什么 ， 但 这 并 不 意味 着 无 法 进一步 
简化 c# 编 程 的 某 些 方面 ， 或 者 C# 和 其 他 技术 之 间 的 关系 不 能 更 加 流畅 

本 章 还 将 对 前 面 几 章 构建 的 CardLib 代码 进行 了 最 终 修改 ， 并 使 用 CardLib 来 创建 扑克 有 牌 游戏 。 
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13.1 :: 运 算 符 和 全 局 名 称 空间 限定 符 


: 运 得 符 提供 了 另 一 种 访问 名 称 空间 中 类 型 的 方式 。 如 果 要 使 用 一 个 名 称 空间 的 别名 ， 但 该 别名 与 实际 名 
称 空间 层次 结构 之 间 的 界限 不 清晰 ， 束 必须 使 用 :: 运 算得 。 在 那 种 情况 下 ， 名 称 空间 层次 结构 优先 于 名 称 空间 
别名 。 为 曾 明 其 含义 ， 考 虑 下 列 代 码 : 


using MyNamespaceAlias = MyRootNamespace.MyNestedNamespace; 
namespace MyRootNamespace 
{ 
namespace MyNamespaceAlias 
{ 
public class MyClass {} 


} 
namespace MyNestedNamespace 
{ 

public class MyClass {} 


} 
} 


MyRootNamespace 中 的 代码 使 用 以 下 代码 引用 一 个 类 : 
MyNamespaceAlias.MyClass 


这 行 代 码 引 用 的 类 是 MyRootNamespace.MyNamespaceAlias.MyClass, fi] 4s MyRootNamespace.MyNested- 
Namespace.MyClass。 也 就 是 说 ，MYRootNamespace MyNamespaceAlias 名 称 空间 隐藏 了 由 using 语句 定义 的 别 
名 ， 访 别名 引用 MyRootNamespace. MyNestedNamespace 名 称 空 团 。 仍 然 可 以 访问 这 个 名 称 空间 以 及 其 中 包含 
的 类 ， 但 需要 使 用 不 同 的 语法 : 

MyNestedNamespace.MyClass 

355. xu EH: SN: 

MyNamespaceAlias: :MyClass 


使 用 这 个 运算 符 会 迫使 编译 器 使 用 由 using 语句 定义 的 别名 ， 因 此 代码 引用 MyRootNamespace. 
MyNestedNamespace.MyClass. 

-: 运 算 符 还 可 以 与 global 关 键 字 一 起 使 用 ， 它 实际 上 是 项 级 根 名 称 空间 的 别名 。 这 有 助 于 更 清晰 地 说 明 要 引 
用 哪个 名 称 空 间 ， 如 下 所 示 : 


global: :System.Collections.Generic.List<int> 


这 是 希望 使 用 的 类 ， 即 List<T> 泛 型 集合 类 。 它 肯定 不 是 用 下 列 代码 定义 的 类 : 
namespace MyRootNamespace 
{ 

namespace System 


{ 


namespace Collections 


namespace Generic 
class List<T> {} 
} 
} 
} 
} 
当然 , 应 避免 使 名 称 空 间 的 名 称 与 已 有 的 .NET 名 称 空 间 相 同 ， 但 这 个 问题 只 在 大 型 项 目 中 才 会 出 现 ， 作 为 
大 型 开发 队伍 中 的 一 员 进 行 开 发 时 ， 此 类 问题 尤其 严重 。 使 用 :: 运 算 符 和 global 关键 字 可 能 是 访问 所 需 类 型 的 
唯一 方式 。 
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13.2 定制 异常 


第 7 章 讨论 了 异常 ， 并 解释 了 如 何 使 用 try...catch..finally 块 处 理 它们 。 我 们 还 论述 了 几 个 标准 的 .NET 异常 ， 
包括 异常 的 基 类 System.Exception。 在 应 用 程序 中 ， 有 时 也 可 以 从 这 个 基 类 中 派生 自己 的 异常 类 ， 并 使 用 它们 ， 
而 不 古 使 用 标准 的 异 第 。 这 样 束 可 以 把 更 具体 的 信息 友 送 给 捕获 该 异 闸 的 代码 ， 让 处 理 异 第 的 捕获 代码 更 有 和 付 
对 性 。 例 如 ， 可 以 给 异 向 类 添加 一 个 新 属性 ， 以 便 访 问 茶 些 撒 层 信息 ， 这 样 异 种 的 接收 代码 融 可 以 做 出 必要 的 
改变 ， 或 者 仅 给 出 异 第 起 因 的 更 多 信息 。 


注意 : 

System 名 称 空间 中 有 两 个 基本 的 异常 类 : ApplicationException 和 SystemException， 它 们 派生 于 Exception. 
SystemException 用 作 .NET Framework 预定 义 的 异常 的 基 类 ，ApplicationException 由 开发 人 员 用 于 派生 自己 的 
异常 类 。 但 最 近 的 最 佳 做 法 是 不 从 这 个 类 中 派生 和 异常， 而 应 使 用 Exception. 


给 CardLib 添加 定制 异常 


为 演示 定制 异常 的 用 法 ， 最 好 通过 升级 CardLib 项 目 来 说 明 。 目 前 ， 如 果 试 图 访问 索引 小 于 0 或 大 于 51 的 
扑克 有 牌 ，Deck.GetCard0 方 法 束 会 抛 出 一 个 标准 的 .NET 异 第 ， 但 下 面 改 为 使 用 一 个 定制 异 第 。 
首先 需要 在 BeginningCSharp7\Chapterl3 目录 中 创建 一 个 新 的 类 库 项 目 Ch13CardLib， 像 以 前 一 样 把 类 从 
Chl2CardLib 中 复制 过 来 ， 并 把 名 称 空间 改 为 Chl13CardLib。 接 着 定义 该 异常 。 方 法 是 使 用 在 新 类 文件 
CardOutOfRangeException.cs 中 定义 的 一 个 新 类 ， 这 个 新 类 是 使 用 Project | Add Class 命令 添加 到 Ch13CardLib 
项 目 中 的 (这 段 代 人 码 包 含 在 Ch13CardLib\CardOutOfRangeException.cs 文件 中 ): 
public class CardOutOfRangeException : Exception 
private Cards deckContents; 
public Cards DeckContents 


{ 
get { return deckContents; } 


public CardoOutofRangeException (Cards sourceDeckContents) 
: base("There are only 52 cards in the deck.") 


deckContents = sourceDeckContents; 
} 
} 


这 个 类 的 构造 函数 需要 使 用 Cards 类 的 一 个 实例 , 它 允 许 通过 DeckContents 属性 来 访问 这 个 Cards 对 象 ， 
A Exception 基 类 构造 函数 提供 合适 的 错误 信息 ， 使 该 错误 信息 可 以 通过 类 的 Message 属性 得 到 。 

接着 在 Deck.cs 中 添加 抛 出 该 异常 的 代码 ， 苦 换 原 来 的 标准 异常 (这 段 代 码 包 含 在 Chl3CardLib\Deck.cs X: 
件 中 ): 


public Card GetCard(int cardNum) 
{ 


if (cardNum >= 0 && cardNum <= 51) 
return cards[cardNum]; 
else 
throw new CardOutofRangeException(cards.Clone() as Cards); 
} 

CardOutOfRangeException 类 的 DeckContents 属性 是 通过 对 Deck 对 象 的 当前 内 容 ( 其 形式 是 一 个 Cards 对 象 ) 
进行 深度 复制 来 初始 化 的 。 这 表示 ， 此 时 的 内 容 是 异常 抛 出 时 的 内 容 ， 所 以 随后 对 Deck 内 容 的 修改 不 会 丢失 
这 些 信息 。 

要 进行 测试 ， 使 用 下 面 的 客户 病人 代码 (这 段 代码 包含 在 Ch13CardClientProgram.es 文件 中 ): 

Deck deckl = new Deck(); 

try 


Card myCard = deckl.GetCard(60); 
} 
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catch (CardOutOfRangeException e) 


WriteLine(e.Message); 
WriteLine (e.DeckContents[0]); 


} 

ReadKey () ; 

添加 对 Chl3CardLib.dll, using static System.Console 和 using Ch13CardLib 的 引用 后 ， 执 行 代码 ， 结 果 如 图 13-1 
所 示 。 


13-1 


Rr is GRE HY Message RESE RRE. 我 们 还 通过 DeckContents 显示 了 Cards 对 象 中 的 第 一 张 
牌 ， 以 证 明 可 以 通过 定制 的 异 笛 对 象 来 访问 Cards 集合 。 


13.3 ”事件 


本 市 主要 讨论 .NET 中 最 常用 的 OOP 技术 : 事件 。 像 往 沼 一样， 首先 介绍 基础 知识 , 分 析 事 件 到 乓 是 什么 。 
之 后 讨论 几 个 简单 事件 ， 看 看 使 用 它们 可 以 做 什么 。 然 后 论述 如 何 创建 和 使 用 目 己 的 事件 。 

本 章 最 后 介绍 如 何 给 CardLib 类 库 添加 一 个 事件 ， 使 该 类 库 更 完整 。 另 外 ， 因 为 这 是 在 介绍 一 些 更 高 级 论 
题 之 前 的 最 后 一 部 分 ， 所 以 我 们 还 将 创建 一 个 使 用 该 类 库 的 有 趣 扑克 牌 游戏 应 用 程序 。 
13.3.1 事件 的 含义 

SAU Hi, AA EMAAR RGU), JF E SRI CR TEINS RA. AEE AL 
个 重要 区 别 。 最 重要 的 区 别 是 并 没有 与 try..…catch 类 似 的 结构 来 处 理事 件 ， 你 必须 订阅 (subscribe) 它 们 。 订 阅 一 
个 事件 的 含义 是 提供 代码 ， 在 事件 及 生 时 执行 这 些 代 码 ， 它 们 称 为 事件 处 理 程 订 。 

单个 事件 可 供 多 个 处 理 程序 订阅 ， 在 该 事件 及 生 时 ， 这 些 处 理 程序 者 会 锌 调用 ， 其 中 包括 引 及 该 事件 的 对 
象 所 在 的 类 中 的 事件 处 理 程序 ， 但 事件 处 理 程序 也 可 能 在 其 他 类 中 。 

事件 处 理 程序 本 身 都 是 简单 方法 。 对 事件 处 理 方法 的 唯一 限制 是 它 必须 匹配 事件 所 要 求 的 返回 类 型 和 参数 。 
这 个 限制 是 事件 定义 的 一 部 分 ， 由 一 个 委托 指定 。 


注意 : 

在 事件 中 使 用 委托 是 非常 有 用 的 。 第 6 章 介 绍 了 委托 ， 读 者 可 以 温习 这 一 部 分 ， 复 习 一 下 委托 是 什么 以 及 
如 何 使 用 它们 。 

基本 处 理 过 程 如 下 所 示 : 首先 ,应 用 程序 创建 一 个 可 以 引发 事件 的 对 象 . 例 如 ,假定 一 个 即时 消息 传送 (instant 
messaging) 应 用 程序 创建 的 对 象 表示 一 个 远程 用 户 的 连接 。 当 接收 到 远程 用 户 通过 该 连接 传送 来 的 消息 时 ， 这 
个 连接 对 象 会 引发 一 个 事件 ， 如 图 13-2 所 示 。 


接着 ， 应 用 程序 订阅 事件 。 为 此 ， 即 时 消息 传送 应 用 程序 将 定义 一 个 方法 ， 该 方法 可 以 与 事件 指定 的 委托 
类 型 一 起 使 用 ， 把 这 个 方法 的 一 个 引用 传送 给 事件 ， 而 事件 的 处 理 方法 可 以 是 另 一 个 对 象 的 方法 ， 例 如 当 接收 
到 消息 时 进行 显示 的 显示 设备 对 象 ， 如 图 13-3 所 示 。 
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引 友 事件 后 ， 丈 通知 订阅 器 。 当 接收 到 通过 连接 对 象 传 来 的 即时 消息 时 ， 束 调用 显示 设备 对 象 上 的 事件 处 
理 方法 。 因 为 我 们 使 用 的 是 一 个 标准 方法 ， 所 以 引发 事件 的 对 象 可 以 通过 参数 传送 任何 相关 的 信息 ， 这 样 就 大 
大 增加 了 事件 的 通用 性 。 在 本 例 中 ， 一 个 参数 是 即时 消息 的 文本 ， 事 件 处 理 程序 可 在 显示 设备 对 象 上 显示 它 ， 
加 图 13-4 所 示 。 


13.3.2 ”处 理事 件 


如 前 所 述 ， 要 人 处理 事件 ， 雷 要 提供 一 个 事件 处 理 方法 来 订阅 事件 ， 该 方法 的 返回 类 型 和 参数 应 该 匹配 事件 
指定 的 委托 。 下 面 的 示例 使 用 一 个 简单 的 计时 器 对 象 引发 事件 ， 调 用 一 个 处 理 方法 。 


试 一 试 ”处理 事件 : Ch13Ex01\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex01。 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System. Threading. Tasks; 
using System.Timers; 

using static System.Console; 
namespace Ch13Ex01 

{ 


class Program 
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static int counter = 0; 


static string displayString = 
"This string will appear one letter at a time. "; 

static void Main(string[] args) 
{ 

Timer myTimer = new Timer (100); 

myTimer.Elapsed += new ElapsedEventHandler (WriteChar) ; 

myTimer.Start(); 

system. Threading. Thread.Sleep (200); 

ReadKey () ; 


static void WriteChar(object source, ElapsedEventArgs e) 


Write (displayString[counter++ $ displayString.Length]): 
) 
} 
} 


(3) 运行 应 用 程序 (局 动 后 ， 按 任意 键 将 终止 执行 程序 )， 在 经 过 短暂 运行 后 ， 将 显示 如 图 13-5 所 示 的 结果 。 


示例 说 明 

用 于 引发 事件 的 对 象 是 System.Timers.Timer 类 的 一 个 实例 。 使 用 一 个 时 间 段 (以 量 秒 为 单位 ) 来 初始 化 该 对 
象 。 当 使 用 Start0 方 法 局 动 Timer 对 象 时 ,会 引发 一 系列 事件 ， 且 是 根据 指定 的 时 间 段 来 引发 这 些 事 件 。MainO 
用 100 晓 秒 初始 化 Timer 对 象 ， 所 以 在 局 动 该 对 象 后 ，1 秒 钟 内 将 引发 10 次 事件 : 


static void Main(string[] args) 


{ 


Timer myTimer = new Timer(100); 
Timer 对 象 有 一 个 Elapsed 事件 ， 这 个 事件 要 求 事件 处 理 程序 必须 匹配 ~System.Timers.ElapsedEventHandler 
委托 类 型 的 返回 类 型 和 参数 ， 该 委托 是 NET Framework 中 定义 的 标准 委托 之 一 ， 指 定 了 如 下 所 示 的 返回 类 型 
和 参数; 


void <MethodName>(object source, ElapsedEventArgs e); 


Timer 对 象 的 第 一 个 参数 是 它 本 有 身 的 引用 ， 第 二 个 参数 则 是 ElapsedEventArgs 对 象 的 一 个 实例 。 现 在 可 以 
不 考虑 这 些 参数 ， 后 面 将 论述 它们 。 
在 代码 中 ， 有 一 个 匹配 该 返回 类 型 和 参数 的 方法 : 
static void WriteChar(object source, ElapsedEventArgs e) 


Write (displayString[counter++ $ displayString.Length]); 
} 


这 个 方法 使 用 Program 的 两 个 静态 字段 counter 和 displayString 来 显示 一 个 字符 。 每 次 调用 该 方法 时 ， 显 
示 的 字符 都 不 相同 。 
下 一 个 任务 是 把 这 个 处 理 程序 与 事件 关联 起 来 一 一 即 订阅 它 。 为 此 ， 可 以 使 用 += 运 算 符 ， 给 事件 添加 一 个 
处 理 程序 ， 其 形式 是 使 用 事件 处 理 方法 初始 化 的 一 个 新 委托 实例 : 
men void Main(string[] args) 


Timer myTimer - new Timer(100); 
myTimer.Elapsed += new ElapsedEventHandler (WriteChar); 


这 个 命令 (使 用 有 扣 古 怪 的 语法 ， 专 用 于 委托 ) 在 列表 中 添加 一 个 处 理 程序 ， 当 引发 Elapsed SHIN, 334 3 
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用 该 处 理 程序 。 可 给 这 个 列表 添加 任意 多 个 处 理 程 序 ， 只 要 它们 满足 指定 的 条 件 即 可 。 当 引 友 事件 时 ， 会 依次 
调用 每 个 处 理 程序 。 
Main0 剩 余 的 任务 是 司 动 计 时 器 : 
myTimer.Start(); 
我 们 不 想 在 处 理 完 任何 事件 前 终止 应 用 程序 ， 所 以 要 让 Main0 函 数 一 直 执 行 。 最 简单 的 方式 是 请 求 用 户 输 
入 ， 因 为 这 个 命令 要 在 用 户 按 下 任意 键 后 ， 才 会 停止 处 理 。 


ReadKey () ; 


这 里 ，Main0 中 的 处 理会 停止 ， 但 Timer 对 象 中 的 处 理 将 继续 。 当 该 对 象 引 发 事件 时 ， 束 调用 WriteChar() 
方法 ， 同 时 该 方法 运行 ReadLine0 语 句 。 使 用 System.Threading.Thread.Sleep(200) 语 句 是 为 了 让 计时 器 有 机 会 把 
消息 发 送 给 控制 台 应 用 程序 。 

注意 ， 可 使 用 上 一 章 介绍 的 方法 组 概念 来 稍 简化 添加 事件 处 理 程序 的 语法 : 


myTimer.Elapsed += WriteChar; 


最 终结 果 是 完全 相同 的 , 但 不 必 喧 式 指定 委托 类 型 , 纺 详 项 会 根据 使 用 事件 的 上 下 文 来 指定 它 。 但 是 ， 
许多 程序 员 不 辟 欢 这 个 语法 ， 因 为 它 降低 了 可 读 性 一 一 个 再 能 一 眼看 出 使 用 了 什么 委托 类 型 。 如 果 豆 欢 ， 
可 以 使 用 这 个 语法 ， 但 为 了 清晰 起 见 ， 本 章 使 用 的 所 有 委托 都 是 显 陈 指定 的 。 


1333 ”定义 事件 


现在 论述 如 何 定义 和 使 用 自己 的 事件 。 我 们 将 使 用 本 节 前 面 介 绍 的 即时 消息 传送 应 用 程序 示例 ， 并 创建 
一 个 Connection 对 象 ， 该 对 象 引 发 由 Display 对 象 处 理 的 事件 。 


试 一 试 ”定义 事件 : Ch13Ex02 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex02。 
(2) 添加 一 个 新 类 Connection， 并 修改 Connection.cs， 如 下 所 示 : 


using System; 
using System.Collections.Generic; 
using System.Ling; 
using System.Text; 
using System. Threading.Tasks; 
using System.Timers; 
using static System.Console; 
namespace Ch13Ex02 
{ 
public delegate void MessageHandler (string messageText) ; 
public class Connection 
{ 
public event MessageHandler MessageArrived; 
private Timer pollTimer; 
public Connection() 
{ 
pollTimer = new Timer (100) ; 
pollTimer.Elapsed += new ElapsedEventHandler (CheckForMessage) ; 
} 
public void Connect() => pollTimer.Start(); 
public void Disconnect() => pollTimer.Stop(); 
private static Random random = new Random(); 
private void CheckForMessage (object source, ElapsedEventArgs e) 
{ 
WriteLine ("Checking for new messages."); 
if ((random.Next(9) == 0) && (MessageArrived '- null)) 
{ 
MessageArrived ("Hello Donna!"); 
} 
} 
] 
} 
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(3) 添加 一 个 新 类 Display， 并 修改 Display.cs， 如 下 所 示 : 


using static System.Console; 
namespace Chl3Ex02 


{ 
public class Display 
{ 
public void DisplayMessage (string message) 
=> WriteLine($"Message arrived: {message}") ; 
} 
} 


(4) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


static void Main(string[] args) 
{ 
Connection myConnection = new Connection () ; 
Display myDisplay = new Display (); 
myConnection.MessageArrived += 
new MessageHandler (myDisplay .DisplayMessage) ; 
myConnection.Connect (); 
ReadKey () ; 
} 


(5) 运行 该 应 用 程序 ， 其 结果 如 图 13-6 所 示 。 


图 13-6 


示例 说 明 
这 个 应 用 程序 中 的 大 部 分 工作 是 由 Connection 类 完成 的 。 这 个 类 的 实例 使 用 如 本 章 第 一 个 示例 中 所 示 的 
Timer 对 象 ， 在 类 的 构造 函数 中 初始 化 它 ， 并 通过 Connect0 和 Disconnect0 访 问 它 的 状态 (可 访问 和 禁止 访问 ): 


public class Connection 


{ 
private Timer pollTimer; 
public Connection () 
{ 
pollTimer = new Timer(100); 
pollTimer.Elapsed += new ElapsedEventHandler (CheckForMessage) ; 
public void Connect () => pollTimer.Start(); 
public void Disconnect() => pollTimer.Stop(); 
} 


在 构造 图 数 中 ,我 们 还 以 与 第 一 个 示例 相同 的 方式 注册 了 Bapsed 事件 的 一 个 事件 处 理 程 序 。 每 当 调 用 这 个 
处 理 程序 方法 CheckForMessage0 的 次 数 达 到 10 次 后 ， 束 会 引 友 一 个 事件 。 在 分 析 它 的 代码 前 ， 和 先 来 分 析 事 
件 的 定义 。 

在 定义 事件 前 ， 必 须 首 先 定义 一 个 委托 类 型 ， 以 用 于 该 事件 ， 这 个 委托 类 型 指定 了 事件 处 理 方 法 必须 拥有 
的 返回 类 型 和 参数 。 为 此 ， 我 们 使 用 标准 的 委托 语法 ， 在 Ch13Ex02 名 称 空间 中 将 该 委托 定义 为 公共 类 型 ， 使 
该 类 型 可 供 外 部 代码 使 用 : 


namespace Ch13Ex02 
{ 
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public delegate void MessageHandler (string messageText) ; 

这 个 委托 类 型 称 为 MessageHandler, Æ void 方法 的 签名 ， 它 有 一 个 sting 参数 。 使 用 这 个 参数 可 以 把 
Connection 对 象 收 到 的 即时 消息 友 送 给 Display 对 象 。 定 义 了 委托 (或 者 找到 合适 的 现 有 委托 ) 后 ， 束 可 以 把 事 
件 本 号 定义 为 Connection 类 的 一 个 成 员 : 

public class Connection 
public event MessageHandler MessageArrived; 

给 事件 命名 (这 里 使 用 名 称 MessageArrived), 在 声明 时 ,使 用 event KEF, 并 指定 要 使 用 的 委托 类 型 (前 面 
定义 的 MessageHandler 委托 类 型 )。 以 这 种 方式 声明 事件 后 ， 束 可 以 引 肥 它 ， 做 法 是 按 名 称 来 调用 它 ， 融 像 它 
是 一 个 其 返回 类 型 和 参数 是 由 委托 指定 的 方法 一 样 。 例 如 ， 使 用 下 面 的 代码 引发 这 个 事件 : 

MessageArrived("This is a message."); 

MRE MABE AAA IBA son] DEAR Pii fad: 


MessageArrived(); 


如 果 定 义 了 较 多 参数 ， 束 需要 用 比较 多 的 代码 来 引发 事件 。CheckForMessage0 方 法 如 下 所 示 : 


private static Random random = new Random(); 
private void CheckForMessage (object source, ElapsedEventArgs e) 
{ 

WriteLine ("Checking for new messages."); 

if ((random.Next(9) == 0) && (MessageArrived != null)) 


MessageArrived ("Hello Mami!"); 
} 
} 


使 用 前 面 章 节 中 介绍 的 Random 类 的 实例 ， 生 成 一 个 介 于 O~9 之 间 的 随机 数 ， 如 果 访 随机 数 为 0， 残 引 皮 
一 个 事件 ， 它 的 上 友 生 概率 为 10%。 这 类 似 于 轮 询 连接 ， 看 看 是 否 接收 到 消息 ， 不 可 能 每 次 检测 时 ， 痢 没有 接收 
SI. ARTI 48-45 Connection 的 实例 分 隔 开 ， 使 用 了 Random 类 的 一 个 私有 前 态 实例 。 

注意 ， 这 里 还 提供 了 其 他 逻辑 。 只 有 表达 式 MessageArrived != null 7j true 时 ， 才 引发 一 个 事件 。 这 个 表达 
式 也 使 用 了 委托 语法 ， 但 语法 稍 有 不 同 ， 其 含义 是 “事件 是 否 有 订阅 者 ” ”。 如 果 没 有 订阅 者 ，MessageArrived 
就 是 null， 也 就 不 会 引 上 事件 。 

订阅 事件 的 类 是 Display， 它 包含 一 个 方法 DisplayMessage0， 其 定义 如 下 所 示 : 


public class Display 
i 
public void DisplayMessage(string message) 
=> WriteLine($"Message arrived: [message]"); 


} 
这 个 方法 匹配 委托 类 型 (而 且 是 公共 的 ， 如 果 类 不 是 生成 该 事件 的 类 ， 则 其 事件 处 理 程序 必须 是 公共 的 )， 
所 以 可 用 它 来 啊 应 MessageArrived 事件 。 
Main0 中 的 代码 初始 化 了 Connection 和 Display 类 的 实例 ， 把 它们 关联 起 来 ， 开 始 执行 任务 。 这 里 需要 的 代 
码 类 似 于 第 一 个 示例 中 的 代码 : 


static void Main(string[] args) 

{ 
Connection myConnection = new Connection (); 
Display myDisplay = new Display(); 
myConnection.MessageArrived += 

new MessageHandler (myDisplay.DisplayMessage); 

myConnection.Connect (); 
System.Threading.Thread.Sleep(200); 
ReadKey () ; 

} 


再 次 调用 ReadKey0O， 当 开始 执行 Connection 对 象 的 ConnectO 方 法 并 增加 一 段 延 迟 时 间 后 ， 暂 停 Main0) 
的 处 理 。 
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1. 多 用 途 的 事件 处 理 程 序 

前 面 Timer.Elapsed 事件 的 委托 包含 了 事件 处 理 程序 中 常见 的 两 类 参数 ， 如 下 所 示 : 

€ object source 一 一 引发 事件 的 对 象 的 引用 

e FlapsedEventArgs e 一 一 由 事件 传送 的 参数 

在 这 个 事件 (以 及 许多 其 他 的 事件 ) 中 使 用 object 类 型 参数 的 原因 是 ， 我 们 常常 要 为 由 不 同 对 象 引 发 的 几 个 
相同 事件 使 用 同一 个 事件 处 理 程序 ， 但 仍 要 指定 是 哪个 对 象 生 成 了 事件 。 

要 说 明 这 一 点 ， 下 面 将 扩展 上 一 个 示例 。 


试 一 试 使 用 多 用 途 的 事件 处 理 程序 :Ch13Ex03 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 台 应 用 程 订 Ch13Ex03。 

(2) 复制 Ch13Ex02 中 Program.cs, Connection.cs 和 Display.cs 的 代码 ， 并 将 每 个 文件 中 的 Ch13Ex02 
名 称 空 间 改 成 Ch13Ex03. 

(3) 添加 一 个 新 类 MessageArrivedEventArgs, Irt MessageArrivedEventArgs.cs， 如 下 所 示 : 


namespace Ch13Ex03 
{ 
public class MessageArrivedEventArgs : EventArgs 
{ 
private string message; 
public string Message 
{ 
get { return message; } 
} 
public MessageArrivedEventArgs() => 
message — "No message sent."; 


public MessageArrivedEventArgs (string newMessage) -- 
message — newMessage; 
} 
} 


(4) 修改 Connection.cs， 如 下 所 示 : 


namespace Ch13Ex03 
{ 
// delegate definition removed 
public class Connection 
{ 
public event EventHandler<MessageArrivedEventArgs> MessageArrived; 
public string Name { get; set; } 


private void CheckForMessage(object source, EventArgs e) 
i 
WriteLine("Checking for new messages."); 
if ((random.Next(9) == 0) && (MessageArrived !- null)) 
{ 
MessageArrived(this, new MessageArrivedEventArgs ("Hello Mami!")); 
} 
} 


} 
} 
(5) 修改 Display.cs， 如 下 所 示 : 


public void DisplayMessage (object source, MessageArrivedEventArgs e) 

{ 
WriteLine($"Message arrived from: {( (Connection) source) .Name}") ; 
WriteLine($"Message Text: {e.Message}"); 

} 

(6) 修改 Program.cs, A FATA: 

static void Main(string[] args) 

Connection myConnectionl = new Connection () ; 


myConnectionl.Name = "First connection."; 
Connection myConnection2 = new Connection () ; 
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myConnection2.Name = "Second connection."; 
Display myDisplay = new Display(); 
myConnectionl.MessageArrived += myDisplay.DisplayMessage; 
myConnection2.MessageArrived += myDisplay.DisplayMessage; 
myConnectionl.cConnect (); 
myConnection2.Connect(); 
System.Threading.Thread.Sleep (200); 
ReadKey () ; 

] 


(7) 运行 该 应 用 程序 ， 其 结果 如 图 13-7 所 示 。 


示例 说 明 
发 送 一 个 引发 事件 的 对 象 引 用 ， 将 其 作为 事件 处 理 程序 的 一 个 参数 ， 就 可 以 为 不 同 对 象 定 制 处 理 程 序 的 啊 
应 。 利 用 该 引用 可 以 访问 源 对 象 ， 包 括 它 的 属性 。 
通过 发 送 包 舍 在 派生 于 System.EventArgs( 与 ElapsedEventArgs 相同 ) 的 类 中 的 参数 , 束 可 以 将 其 他 必要 信息 
提供 为 参数 (例如 ，MessageArrivedEventArgs 类 上 的 Message 参数 )。 
另外 ， 这 些 参数 也 将 得 益 于 多 态 性 。 可 为 MessageAmived 事件 定义 一 个 处 理 程 序 ， 如 下 所 示 : 
public void DisplayMessage(object source, EventArgs e) 
i WriteLine($"Message arrived from: {( (Connection) source) .Name}"); 


WriteLine($"Message Text: { ((MessageArrivedEventArgs)e) .Message}"); 


} 
这 个 应 用 程序 将 像 以 前 那样 执行 ， 但 DisplayMessage0 方 法 变 得 更 加 通用 (至 少 从 理论 上 讲 是 这 样 的 一 一 需 
要 使 用 更 多 实现 代码 ， 才 能 满足 生产 环境 的 要 求 )。 这 个 处 理 程 序 还 可 以 处 理 其 他 事件 ， 例 如 TimerElapsed 事 
fr. 但 必须 修改 处 理 程序 的 内 部 代码 ， 这 样 ， 在 引发 这 个 事件 时 ， 发 送 过 来 的 参数 才 会 得 到 正确 处 理 (以 这 种 方 
式 把 它们 转换 为 Connection 和 MessageArrivedEventArgs 对 象 ， 会 抛 出 一 个 异 利 ， 所 以 这 里 应 使 用 as ia SERT, 
并 检查 null 值 )。 


2. EventHandler #1324! EventHandler<T> 类 型 


大 多 数 情况 下 ， 都 应 齐 循 上 一 节 提 出 的 模式 ， 使 用 返回 类 型 为 void、 而 两 个 参数 的 事件 处 理 程序 。 第 一 个 
参数 的 类 型 是 object， 是 事件 源 。 第 二 个 参数 的 类 型 派生 于 System.EventArgs, 包含 任意 事件 实 参 。 这 非常 常见 ， 
为 此 .NET 提供 了 两 个 委托 类 型 EventHandler 和 EventHandler<T>， 以 便 定 义 事件 。 它 们 都 是 委托 ， 使 用 标准 的 
事件 处 理 模式 。 泛 型 版 本 允许 指定 要 使 用 的 事件 实 参 的 类 型 。 

在 前 面 的 示例 中 演示 了 这 一 点 ， 使 用 了 汉 型 委托 类型 EventHandler<T>， 如 下 所 示 : 


public class Connection 
{ 
public event EventHandler<MessageArrivedEventArgs> MessageArrived; 


这 显然 是 件 好 事 ， 因 为 它 人 简化 了 代码 。 一 般 来 说 ， 在 定义 事件 时 ， 最 好 使 用 这 些 委 托 类 型 。 注 意 ， 如 果 事 


254 | 第 | 部 分 Cit BE 


件 不 需要 事件 实 参数 据 ， 仍 然 可 以 使 用 EventHandler 委托 类 型 ， 只 不 过 要 传递 EventArgs Empty 作为 实 参 值 。 

3. 返回 值 和 事件 处 理 程序 

前 面 的 所 有 事件 处 理 程序 都 使 用 void 类 型 的 返回 值 。 可 以 为 事件 提供 返回 类 型 ， 但 这 会 出 问题 。 这 是 因为 
引发 给 定 的 事件 ， 可 能 会 调用 多 个 事件 处 理 程序 。 如 果 这 些 处 理 程序 都 返回 一 个 值 ， 那 么 我 们 不 知道 该 使 用 哪 
个 返回 值 。 

系统 处 理 这 个 问题 的 方式 是 ， 只 允许 访问 由 事件 处 理 程 序 最 后 返回 的 那个 值 ， 也 融 是 最 后 一 个 订阅 该 事件 
的 处 理 程序 返回 的 值 。 这 个 功能 在 某 些 情况 下 是 有 用 的 ， 但 最 好 使 用 void 类 型 的 事件 处 理 程 序 ， 且 避免 使 用 
out 类 型 的 参数 (如 果 使 用 out 参数 ， 参 数 返 回 的 值 的 源头 就 是 模 糊 不 清 的 )。 

4. 匿名 方法 

除了 定义 事件 处 理 方法 外 ， 还 可 以 选择 使 用 匿名 方法 (anonymous methodj。 匿 名 方法 实际 上 并 非 传统 意义 
上 的 方法 ， 它 不 是 某 个 类 上 的 方法 ， 而 纯粹 是 为 用 作 委 托 目 的 而 创建 的 。 

要 创建 匿名 方法 ， 雷 要 使 用 下 面 的 代码 : 

delegate (parameters) 


// Anonymous method code. 


其 中 parameters 是 一 个 参数 列表 ， 这 些 参数 匹配 正在 实例 化 的 委托 类 型 ， 由 匿名 方法 的 代码 使 用 ， 例 如 ; 
delegate (Connection source, MessageArrivedEventArgs e) 


{ 
// Anonymous method code matching MessageHandler event in Chl3Ex03. 


例如 ， 使 用 这 段 代 码 可 以 完全 统 过 Ch13Ex03 中 的 Display. DisplayMessage() 77 7X: 


myConnectionl.MessageArrived += 
delegate (Connection source, MessageArrivedEventArgs e) 
{ 
WriteLine($"Message arrived from: {source.Name}"); 
WriteLine($"Message Text: {e.Message}") ; 
); 


使 用 匿名 方法 时 要 注意 ， 对 于 包含 它们 的 代码 块 来 说 ， 它 们 是 局 部 的 ， 可 以 访问 这 个 作用 域内 的 局 部 变量 。 
如 果 使 用 这 样 一 个 变量 ， 它 就 成 为 外 部 变量 (outer variable)。 外 部 变量 在 超出 作用 域 时 ， 是 不 会 删除 的 ， 这 与 其 
他 局 部 变量 人 不同， 在 使 用 它们 的 匿名 方法 被 销毁 时 ， 才 会 删除 外 部 变量 。 这 比 我 们 希望 的 时 间 晚 一 些 ， 所 以 要 
格外 小 心 。 如 果 外 部 变量 占用 了 大 量 内 存 ， 或 者 使 用 的 资源 在 其 他 方面 是 比较 兄 叶 的 (例如 资源 数量 有 限 )， 吉 
可 能 导致 内 存 或 性 能 问题 。 


13.4 扩展 和 使 用 CardLib 


前 面 介 绍 了 事件 的 定义 和 使 用 ， 现 在 就 可 以 在 Chl3CardLib 中 使 用 它们 了 。 在 库 中 需要 添加 一 个 
LastCardDrawn 事件 ， 当 使 用 GetCard 获得 Deck 对 象 中 的 最 后 一 个 Card 对 象 时 ， 就 将 引发 该 事件 。 这 个 事件 允 
许 订阅 者 (subscriben) 目 动 重新 洗 牌 ， 减 少 需要 在 客户 端 完 成 的 处 理 。 这 个 事件 将 使 用 EventHandler 委托 类 型 ， 
并 传递 一 个 Deck 对 象 的 引用 作为 事件 源 ， 这 样 无 论处 理 程序 在 什么 地 方 ， 都 可 以 访问 Shuffle0 方 法 。 在 Deck .cs 
中 添加 以 下 代码 以 定义 并 引发 事件 (这 段 代码 包含 在 Ch13CardLib\ Deck.cs 文件 中 ): 

namespace Chl3CardLib 

i public class Deck : ICloneable 


{ 
public event EventHandler LastCardDrawn; 


public Card GetCard(int cardNum) 

1 
if (cardNum >= 0 && cardNum <= 51) 
{ 


第 13 章 高 级 C# 技 术 | 255 


if ((cardNum == 51) && (LastCardDrawn '- null)) 
LastCardDrawn(this, EventArgs.Empty); 
return cards[cardNum]; 
) 
else 
throw new CardOutOfRangeException ((Cards3)cards.Clone()); 
} 


} 

这 是 把 事件 添加 到 Deck 类 定义 需要 的 所 有 代码 。 

开发 CardLib 库 后 ， 就 可 以 使 用 它 了 。 在 结束 讲述 C# 和 .NET Framework 中 OOP 技术 的 这 个 部 分 前 ， 我 们 
将 编写 扑克 有 牌 应 用 程序 的 基本 代码 ， 其 中 将 使 用 我 们 熟 芒 的 扑克 有 牌 类 。 

与 前 面 的 章节 一 样 ， 我 们 将 在 Chl3CardLib 解决 方案 中 添加 一 个 客户 控制 台 应 用 程序 ， 添 加 一 个 对 
Ch13CardLib 项 目的 引用 ， 使 其 成 为 局 动 项 目 。 这 个 应 用 程序 称 为 Ch13CardClient. 

首先 在 Chl3CardClient 的 一 个 新 文件 Player.cs 中 创建 一 个 新 类 Player， 相 应 代码 可 在 本 章 下 载 代 码 的 
Ch13CardClient\Player.cs 文件 中 找到 。 这 个 类 包含 两 个 目 动 属性 : Name( 字 符 串 ) 和 PlayHand (Cards 类 型 )。 这 些 
属性 有 私有 的 set 访问 器 。 但 是 PlayHand 属性 仍 可 以 对 其 内 容 进行 写 入 访问 ， 这 样 就 可 以 修改 玩家 手中 的 扑 
pA o 

FUME RU Mie A NMA, URE, Fre te S “SAFES F ER FX PB, VALER ICE AS Player 
实例 中 Name 属性 的 初始 值 。 

最 后 提供 一 个 bool 类 型 的 方法 HasWon0。 如 果 玩 家 手中 的 扑克 牌 伦 色 都 相同 (一 个 简单 的 取胜 条 件 ， 但 并 
没有 什么 意义 )， 该 万 法 束 返 回 true. 

Player.cs 的 代码 如 下 所 示 : 

using System; 

using System.Collections.Generic; 

using System. Ling; 

using System. Text; . 

using System. Threading. Tasks; 


using Chl3CardLib; 
namespace Chl3CardClient 


{ 
public class Player 
{ 
public string Name { get; private set; } 
public Cards PlayHand { get; private set; } 
private Player() {} 
public Player(string name) 
{ 
Name = name; 
PlayHand = new Cards(); 
} 
public bool HasWon() 
{ 
bool won = true; 
Suit match = PlayHand[0].suit; 
for (int i= 1; i < PlayHand.Count; i++) 
{ 
won &- PlayHand[i].suit == match; 
} 
return won; 
} 
} 
} 


接 看 定义 一 个 处 理 扑 殉 牌 游戏 的 类 Game， 这 个 类 位 于 Chl3CardClient 项 目的 Game.cs 文件 中 ， 它 包含 4 
个 私有 成 员 字 段 : 

e playDeck——Deck 类 型 的 变量 ， 包含 要 使 用 的 一 副 扑 克 有 牌 

e currentCard 一 一 一 个 int 值 ， 用 作 下 一 张 要 翻 开 的 扑 殉 有 牌 的 指针 

e players 一 一 一 个 Player 对 象 数 组 ， 表 示 游 戏 玩 家 

e discardedCards 一 一 Cards 集合 ， 表 示 玩 家 扔 揉 的 扑克 有 隆 ， 但 还 没有 放 回 整 副 牌 中 。 

这 个 类 的 默认 构造 函数 初始 化 了 playDeck 中 的 Deck， 并 洗 牌 ， 把 currentCard 指针 变量 设置 为 0(playDeck 
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中 的 第 一 张 牌 )， 并 关联 了 playDeck.LastCardDrawn 事件 的 处 理 程序 Reshuffle0。 这 个 处 理 程序 将 洗 牌 ， 初 始 化 
discardedCards 集合 ， 并 将 currentCard 重 置 为 0， 准备 从 新 的 一 副 牌 中 读 取 扑 殉 牌 。 

Game 类 还 包含 两 个 实用 方法 : SetPlayers0 可 以 设置 游戏 的 玩家 (Player 对 象 数组 )，DealHands0 给 玩家 发 
REET EAA 7 张 牌 )。 玩 家 的 数量 限制 为 2 一 7 人 ， 硝 保 每 个 玩家 有 足够 多 的 牌 。 

最 后 ，PlayGame0 方 法 包含 游戏 逻辑 。 我 们 将 在 分 析 了 Program cs 中 的 代码 后 介绍 这 个 方法 ，Game.cs HIRI 
余 代码 如 下 所 示 ( 这 段 代 人 码 包含 在 Ch13CardClient\Game.cs 文件 中 ): 


using System; 
using System.Collections.Generic; 
using System.Ling; 
using System.Text; 
using System. Threading.Tasks; 
using Chl3CardLib; 
using static System.Console; 
namespace Chl3CardClient 
{ 
public class Game 
{ 
private int currentCard; 
private Deck playDeck; 
private Player[] players; 
private Cards discardedcCards; 
public Game () 
i 
currentCard = 0; 
playDeck = new Deck (true); 
playDeck.LastCardDrawn += Reshuffle; 
playDeck.Shuffle(); 
discardedCards = new Cards () : 
} 
private void Reshuffle (object source, EventArgs args) 
{ 
WriteLine ("Discarded cards reshuffled into deck."); 
( (Deck) source) .Shuffle() ; 
discardedCards.Clear(); 
currentCard = 0; 
) 
public void SetPlayers(Player[] newPlayers) 
{ 
if (newPlayers.Length > 7) 
throw new ArgumentException ( 
"A maximum of 7 players may play this game."); 
if (newPlayers.Length < 2) 
throw new ArgumentException ( 
"A minimum of 2 players may play this game."); 
players = newPlayers; 


private void DealHands() 
i 
for (int p = 0; p < players.Length; p++) 
i 
for (int c = 0; c < 7; c++) 


players [p] .PlayHand.Add(playDeck .GetCard (currentCard++) ); 


} 
} 
public int PlayGame () 
{ 


// Code to follow. 

l } 
} 
Program.cs 中 包含 Main0 方 法 ， 它 初始 化 并 运行 游戏 。 这 个 方法 执行 以 下 步骤 : 
(1) 显示 引导 画面 。 
(2) 提示 用 户 输入 玩家 数 (2~7)。 
(3) 根据 玩家 数 建 立 一 个 Player 对 象 数组 。 
(4) 给 每 个 玩家 取 名 ， 用 于 初始 化 数组 中 的 一 个 Player 对 象 。 
(5) 创建 一 个 Game 对 象 ， 使 用 SetPlayers0 方 法 指定 玩家 。 
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(6) 使 用 PlayGame0 方 法 月 动 洲 戏 。 

(7) PlayGameO 的 int 返回 值 用 于 显示 一 条 获胜 消息 (返回 的 值 是 Player 对 象 数组 中 获胜 的 玩家 的 索引 )。 

这 个 方法 的 代码 (为 清晰 起 见 ， 加 了 一 些 注释 ) 如 下 所 示 ( 这 段 代码 包含 在 Chl3CardClient\Program.cs X 
件 中 ): 


static void Main(string[] args) 
{ 
// Display introduction. 
WriteLine ("BenjaminCards: a new and exciting card game."); 
WriteLine("To win you must have 7 cards of the same suit in" + 
" your hand."); 
WriteLine(); 
// Prompt for number of players. 
bool inputOK - false; 
int choice = -1; 
d 
{ 
WriteLine ("How many players (2-7)?"); 
string input = ReadLine () ; 
try 
{ 
// Attempt to convert input into a valid number of players. 
choice = Convert.ToInt32 (input); 
if ((choice >= 2) && (choice <= 7)) 
inputOK = true; 
} 
catch 
{ 
// Ignore failed conversions, just continue prompting. 
} 
} while (inputOK == false); 
// Initialize array of Player objects. 
Player[] players = new Player[choice]; 
// Get player names. 
for (int p = 0; p < players.Length; p++) 
{ 


WriteLine($"Player (p + 1}, enter your name:"); 
string playerName = ReadLine(); 
players[p] = new Player (playerName) ; 
} 
// Start game. 
Game newGame = new Game (); 
newGame.SetPlayers (players); 
int whoWon = newGame.PlayGame () ; 
// Display winning player. 
WriteLine($"(players[whoWon].Name) has won the game!"); 
ReadKey () ; 
} 


接 看 分 析 一 下 应 用 程序 的 主体 PlayGame0。 由 于 局 幅 所 限 ， 这 里 不 准备 详细 讲解 这 个 方法 ， 只 是 加 了 一 些 
注释 ， 使 其 更 容易 理解 。 实 际 上 ， 这 些 代码 都 不 复杂 ， 仪 是 较 多 而 已 。 

每 个 玩家 都 可 以 查看 于 中 的 牌 和 果 面 上 的 一 张 翻 开 的 牌 。 他 们 可 以 拾取 这 张 牌 ， 或 者 翻 开 一 张 新 脾 。 在 拾 
取 一 张 牌 后 ， 玩 家 必须 扔 挥 一 张 牌 ， 如果 他 们 拾取 了 时 面 上 的 那 张 牌 ， 融 必须 用 忆 一 张 牌 蔡 换 果 面 上 的 那 张 牌 ， 
或 者 把 扔 抒 的 那 张 牌 放 在 果 面 上 那 张 牌 的 上 面 (把 扔 抒 的 那 张 牌 添加 到 discardedCards 集合 中 )。 

在 分 析 这 段 代码 时 ， 一 个 关键 问题 在 于 Card 对 象 的 处 理 方式 。 必 须 清 楚 ， 这 些 对 象 定义 为 引用 类 型 ， 而 不 
是 值 关 型 (使 用 结构 )。 给 定 的 Card 对 象 似乎 同时 存在 于 多 个 地 方 ， 因 为 引用 可 以 存在 于 Deck XY A. Player 对 象 
的 hand 字段 、discardedCards 集合 和 playCard Xf 2& (5: tf EN SBT) A. REET ERE che. Real ze n] DAA 
于 从 一 副 牌 中 拾取 一 张 新 牌 。 只 有 有 牌 不 在 任何 玩家 的 手中 ， 也 不 在 discardedCards 集合 中 ， 才 能 接 有 党 该 牌 。 

代码 如 下 所 示 : 


public int PlayGame () 


{ 
// Only play if players exist. 
if (players == null) 
return -1; 
// Deal initial hands. 
DealHands(); 
// Initialize game vars, including an initial card to place on the 


258 | 第 | 部 分 Cit 语言 


// table: playCard. 
bool GameWon = false; 
int currentPlayer; 
Card playCard = playDeck.GetCard (currentCard++) ; 
discardedCards .Add(playCard) ; 
// Main game loop, continues until GameWon == true. 
do 
{ 
// Loop through players in each game round. 
for (currentPlayer = 0; currentPlayer < players.Length; 
currentPlayer-t-) 
{ 
//Write out current player, player hand, and the card on the 
// table. 
WriteLine($"(players[currentPlayer].Name)'s turn."); 
WriteLine ("Current hand:"); 
foreach (Card card in players[currentPlayer].PlayHand) 
{ 
WriteLine (card) ; 
} 
ariteLine ($"Card in play: {playCard}"); 
// Prompt player to pick up card on table or draw a new one. 
bool inputOK = false; 
do 
{ 
WriteLine ("Press T to take card in play or D to draw:"); 
string input - ReadLine(); 
if (input.ToLower() —- "t") 
{ 
// Add card from table to player hand. 
WriteLine($"Drawn: {playCard}") ; 
// Remove from discarded cards if possible (if deck 
// is reshuffled it won't be there any more) 
if (discardedCards.Contains (playCard) ) 
{ 
discardedCards.Remove (playCard) ; 
} 
players [currentPlayer] .PlayHand.Add(playCard) ; 
inputOK = true; 
) 
if (input.ToLower() == "d") 
{ 
// Add new card from deck to player hand. 
Card newCard; 
// Only add card if it isn't already in a player hand 
// or in the discard pile 
bool cardIsAvailable; 
do 
{ 
newCard = playDeck.GetCard (currentCard++) ; 
// Check if card is in discard pile 
cardIsAvailable = 'discardedCards.Contains (newCard) ; 
if (cardIsAvailable) 
{ 
// Loop through all player hands to see if newCard 
// is already in a hand. 
foreach (Player testPlayer in players) 
{ 
if (testPlayer.PlayHand.Contains (newCard) ) 
{ 
cardIsAvailable = false; 
break; 


) 
) 
} while ('cardIsAvailable); 
// Add the card found to player hand. 
WriteLine($"Drawn: {newCard}") ; 
players [currentPlayer] .PlayHand.Add(newCard) ; 
inputOK = true; 
} 
} while (inputOK == false); 
// Display new hand with cards numbered. 
WriteLine("New hand:"); 
for (int i = 0; i < players[currentPlayer].PlayHand.Count; i++) 
{ 
WriteLine($"{i + 1): " + 
$"{ players[currentPlayer].PlayHand[il)"); 
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} 
// Prompt player for a card to discard. 
inputOR = false; 
int choice - -1; 
dii 
{ 
WriteLine ("Choose card to discard:"); 
string input = ReadLine() ; 
try 
{ 
// Attempt to convert input into a valid card number. 
choice = Convert. ToInt32 (input); 
if ((choice > 0) && (choice <= 8)) 
inputoOK = true; 


} 
catch 
{ 
// Ignore failed conversions, just continue prompting. 
} 


} while (inputOK == false); 

// Place reference to removed card in playCard (place the card 
// on the table), then remove card from player hand and add 

// to discarded card pile. 

playCard = players [currentPlayer] .PlayHand[choice - 1]; 
players [currentPlayer] .PlayHand.RemoveAt (choice - 1); 
discardedCards.Add (playCard); 

WriteLine($"Discarding: {playCard}"); 

// Space out text for players 

WriteLine(i); 

// Check to see if player has won the game, and exit the player 
// loop if so. 

GameWon = players[currentPlayer] .HasWon () ; 


if (GameWon == true) 
break; 
} 
} while (GameWon == false); 


// End game, noting the winning player. 
return currentPlayer; 


} 
图 13-8 显示 了 一 个 正在 进行 的 游戏 。 


图 13-8 
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作为 最 终 的 练习 ， 请 仔细 得 看 PlayerHasWon 0 中 的 代码 。 有 什么 方法 可 以 使 这 段 代 码 吏 有 效率 ， 每 次 调用 
此 方法 时 ， 可 能 不 需要 检查 每 个 玩家 于 里 的 牌 ? 


13.5 “特性 


本 节 将 简要 介绍 一 种 为 使 用 所 创建 类 型 的 代码 提供 额外 信息 的 方法 :特性 (attribute)。 特 性 让 我 们 可 以 为 代 
码 段 标记 一 些 信息 ， 而 这 样 的 信息 又 可 从 外 部 读 取 ， 并 通过 各 种 方式 来 影响 我 们 所 定义 的 类 型 的 使 用 方式 。 这 
种 手段 通常 被 称 为 对 代码 进行 “装饰 (decorating) ”。 本 部 分 所 包含 的 代码 可 在 本 章 在 线 下 载 页 面 的 
CustomAttributes\Program.cs 文件 中 找到 。 

比如 ， 我 们 要 创建 的 某 个 类 包含 了 一 个 极 简单 的 方法 。 换 句 话 说， 这 个 方法 简单 到 我 们 都 没 必要 去 理 它 。 
但 遗憾 的 是 ， 即 使 简单 ， 我 们 在 应 用 程序 调试 期 间 还 是 不 得 不 对 这 一 代码 进行 检查 。 这 种 情况 下 ， 我 们 就 可 以 
对 该 方法 添加 一 个 特性 ， 告 诉 Visual Studio 在 调试 时 不 要 进入 该 方法 进行 逐 句 调试 ， 而 是 应 该 跳 过 该 方法 ， 直 
接 调试 下 一 条 语句 。 这 样 的 特性 声明 如 下 : 


[DebuggerStepThrough] 
public void DullMethod() { ... } 


上 述 代码 中 所 包含 的 特性 就 是 DebuggerStepThrough]。 所 有 特性 的 添加 方式 都 是 如 此 ， 也 就 是 只 需要 将 特 
性 名 称 用 方 括号 括 起 来 ， 并 写 在 要 应 用 的 目标 代码 前 面 即 可 。 可 以 为 一 段 目标 代码 添加 多 个 特性 ， 将 这 些 特 性 
用 逗号 () 分 隔 开 ， 或 者 用 多 个 方 括号 括 起 来 每 一 个 均 可 。 

上 述 代码 中 所 使 用 的 特性 实际 上 是 通过 DebuggerStepThroughAttribute 这 个 类 来 实现 的 ， 而 这 个 类 位 于 
System.Diagnosties 名 称 空 间 中 ， 因 此 如 果 我 们 要 使 用 上 面 那个 特性 ， 束 必须 使 用 using 语句 来 引用 这 一 名 称 空 
则 。 引 用 该 特性 既 可 以 直接 使 用 其 完整 的 名 称 ， 也 可 以 像 在 前 面 的 代码 中 那样 ， 去 挤 后 级 Attribute. 

通过 上 述 方式 添加 特性 后 ， 编 译 器 驶 会 创建 该 特性 类 的 一 个 实例 ， 然 后 将 其 与 类 方法 关联 起 来 。 茶 些 
特性 可 以 退 过 构造 函数 的 参数 或 属性 进行 目 定 义 ， 并 在 添加 特性 的 时 候 进 行 指 定 ， 例 如 : 


[DoesInterestingThings (1000, WhatDoesItDo = "voodoo")] 
public class DecoratedClass {} 


上 述 特性 就 将 值 1000 传递 给 DoesInterestingThingsAttribute [Fie PAL, FH WhatDoesItDo 属性 的 值 设 置 
JJ^E 4j B "voodoo". 


13.5.1 读 取 特性 


要 读 取 特性 的 值 ， 我 们 必须 使 用 一 种 称 为 “反射 (reflection)” 的 技术 。 这 种 非常 高 级 的 技术 让 我 们 可 以 在 运 
行 的 时 候 动态 检查 类 型 信息 ,甚至 是 在 创建 对 象 的 位 置 , 或 者 在 不 必 知 道具 体 对 象 的 情况 下 直接 调用 某 个 方法 。 
本 书 无 法 详细 介绍 这 一 技术 ， 但 在 使 用 特性 之 前 ， 需 要 了 解 访 技术 的 一 些 基本 知识 。 有 关 该 技术 的 更 多 信息 ， 
可 以 访问 https://docs.microsoft.com/en-us/dotnet/framework/reflection-and-codedom/reflection. 

简单 来 说 ， 反 射 可 以 取得 保存 在 Type 对 象 (本 书 中 会 多 次 提 到 该 对 象 ) 中 的 使 用 信息 ， 以 及 通过 
System.Reflection 名 称 空间 中 的 各 种 类 型 来 获取 不 同 的 类 型 信息 。 在 此 之 前 ， 我 们 已 经 了 解 过 通过 typeof 运 
算 符 从 类 中 快速 获取 类 型 信息 ， 以 及 使 用 GetType0 方 法 从 对 象 实例 中 获取 信息 的 方法 。 通 过 反射 技术 ， 我 们 可 
继续 从 Type 对 象 取得 成 员 信 息 。 基 于 这 个 方法 ， 我 们 就 可 以 从 类 或 类 的 不 同 成 员 中 取得 特性 信息 了 。 

为 此 ， 最 向 单 的 方法 也 就 是 本 书 将 要 为 大 家 介绍 的 唯一 方法 ， 即 通过 Type.GetCustomAttributes0 方 法 来 实 
现 。 这 个 方法 最 多 使 用 两 个 参数 ， 然 后 返回 一 个 包含 一 系列 object 实例 的 数组 ， 每 个 实例 都 是 一 个 特性 实例 。 
第 一 个 参数 是 可 选 的 ， 即 传递 我 们 感 兴 趣 的 类 型 或 右 干 特性 的 类 型 (其 他 所 有 特性 均 会 被 忽略 )。 如 果 不 使 用 这 
一 参数 ， 将 返回 所 有 特性 。 第 二 个 参数 是 必需 的 ， 即 通过 一 个 布尔 值 来 指示 ， 只 想 了 解 类 本 身 的 信息 ， 还 是 除 
了 该 类 之 外 还 希望 了 解 派生 目 该 类 的 所 有 类 。 

例如 ， 下 面 的 代码 可 以 列 出 DecoratedClass 类 的 特性 : 


Type classType = typeof (DecoratedClass); 
object[] customAttributes = classType.GetCustomAttributes (true); 
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foreach (object customAttribute in customAttributes) 


WriteLine ($"Attribute of type {customAttribute} found."); 
} 


通过 这 种 方法 了 解 到 不 同 的 特性 后 , 我 们 就 可 以 为 不 同 的 特性 采取 不 同 的 操作 了 。 这 也 正 是 当 Visual Studio 
遇 到 前 面 介绍 的 DebuggerStepThroughAttribute 特性 时 所 执行 的 操作 。 


13.5.2 ”创建 特性 


通过 System. Attribute 类 进行 派生 ， 我 们 也 可 以 创建 出 目 己 的 特性 。 一般 来 说 ， 如 果 除 了 包含 和 不 包含 特定 
的 特性 外 ， 我 们 的 代码 不 需要 获得 更 多 信息 就 可 以 完成 需要 的 工作 ， 那 么 我 们 不 必 完 成 这 些 额 外 的 工作 。 但 有 
时 ， 如 果 我 们 希望 某 些 特性 可 以 被 自 定义 ， 则 可 以 提供 非 默 认 的 构造 函数 和 /三 可 写 属性 。 

另外 ， 还 需要 为 目 己 的 特性 做 两 个 选择 : 要 将 其 应 用 到 什么 类 型 的 目标 (类 、 属 性 或 其 他 )， 以 及 是 否 可 以 
对 同一 个 目标 进行 多 次 应 用 。 要 指定 上 述 信息 ， 我 们 需要 通过 对 特性 应 用 一 个 特性 来 实现 (这 句 话 实在 是 很 撩 
L1! )， 这 个 特性 就 是 AttributeUsageAttribute。 这 个 特性 这 有 一 个 类 型 为 AttributeTargets 的 构造 图 数 参 数值 ， 通 
过 | 运算 符 即 可 通过 相应 的 枚 举 值 组 合 出 我 们 需要 的 值 。 男 外 ， 该 特性 还 有 一 个 布尔 值 类 型 的 属性 
AllowMultiple， 用 于 指定 是 否 可 以 多 次 应 用 特性 。 

例如 ， 下 面 的 代码 指定 了 一 个 可 以 应 用 到 类 或 属性 中 (一 次 ) 的 特性 : 


[AttributeUsage (AttributeTargets.Class | AttributeTargets.Method, 
AllowMultiple = false) ] 
class DoesInterestingThingsAttribute : Attribute 
{ 
public DoesInterestingThingsAttribute (int howManyTimes) 
i 


HowManyTimes = howManyTimes; 


} 

public string WhatDoesItDo { get; set; } 

public int HowManyTimes { get; private set; } 
} 


这 样 ， 就 可 以 像 前 面 的 代码 上 请 段 中 看 到 的 那样 来 使 用 DoesInterestingThings 特性 了 : 


[DoesInterestingThings (1000, WhatDoesItDo = "voodoo")] 
public class DecoratedClass {} 


只 要 像 下 面 这 样 修改 前 面 的 代码 ， 束 可 以 访问 这 一 特性 的 属性 ; 


Type classType = typeof (DecoratedClass); 
object[] customAttributes = classType.GetCustomAttributes (true); 
foreach (object customAttribute in customAttributes) 
{ 
WriteLine ($"Attribute of type {customAttribute} found."); 
DoesInterestingThingsAttribute interestingAttribute = 
customAttribute as DoesInterestingThingsAttribute; 
if (interestingAttribute '- null) 
{ 
WriteLine ($"This class does {interestingAttribute.WhatDoesItDo} x " + 
$" {interestingAttribute.HowManyTimes}!") ; 
} 
} 


xs Hd SATIN AMT, mA n] AAR 13-9 所 示 的 结果 。 


4 13-9 


“特性 ”这 一 技术 在 所 有 .NET 应 用 程序 都 非 第 有 用 ,特别 是 WPF 和 Universal Windows 应 用 程序 。 本 书 其 
余 的 部 分 会 多 次 涉及 这 一 技术 。 
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13.6 ”初始 化 器 


前 面 的 章节 讲述 了 如 何 用 各 种 方式 实例 化 和 初始 化 对 象 。 它 们 都 需要 在 类 定义 中 添加 初始 化 代码 ， 或 者 使 
用 独立 的 语句 来 实例 化 和 初始 化 对 象 。 我 们 还 了 解 了 如 何 创建 各 种 类 型 的 集合 类 ， 包 括 泛 型 集合 类 。 另 外 ， 把 
集合 的 创建 和 在 集合 中 添加 数据 项 的 操作 合并 起 来 并 没有 什么 简便 方法 。 

对 象 初始 化 器 提供 了 一 种 简化 代码 的 方式 ， 可 以 合并 对 象 的 实例 化 和 初始 化 。 集 合 初始 化 器 提供 了 一 种 简 
涪 的 语法 ， 使 用 一 个 步骤 融 可 以 创建 和 填充 集合 。 本 贡 束 介绍 如 何 使 用 这 两 个 新 特性 。 


13.6.1 SRA as 


考虑 下 面 的 简单 类 定义 : 

public class Animal 

{ 
public string Name { get; set; } 
public int Age { get; set; } 
public double Weight { get; set; } 

} 


这 个 类 有 3 个 属性 , 用 第 10 章 介绍 的 自动 属性 语法 来 定义 。 如果 希望 实例 化 和 初始 化 这 个 类 的 一 个 对 象 实 
就 必须 执行 如 下 几 个 语句: 

Animal animal = new Animal (); 

animal. Name = "Benjamin"; 


animal. Age = 42; 
animal. Weight = 185.4; 


UL RAS XE PARE MS AB, BUSSE CHR EE e AEWA 2 290 X a. 73. T fa] Hoo T 138 
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public class Animal 


例 


i 


public Animal (string name, int age, double weight) 
i Name = name; 
Age = age; 
Weight = weight; 
l — 
这 样 就 可 以 编写 代码 ， 把 实例 化 和 初始 化 合并 起 来 : 
Animal animal = new Animal("Noa", 5, 45.2); 
这 段 代码 工作 得 很 好 , 但 它 会 强制 使 用 Animal FS AVR ANER 3208 BELLE BU in fe HH 7652 4 ERI 
数 的 代码 运行 。 第 需要 提供 无 参 构造 国 数 ， 在 必须 序列 化 关 时 尤其 如 此 : 
public class Animal 


public Animal() {} 


} 
现在 可 以 用 任意 方式 来 实例 化 和 初始 化 Animal 类 , 但 已 在 最 初 的 类 定义 中 添加 几 行 代码 , 为 这 种 灵活 性 提 
供 基 本 结构 。 


进入 对 和 象 初 她 化 器 (object initializer)， 这 是 不 必 在 类 中 添加 籁 外 代码 (如 此 处 详细 说 明 的 构造 函数 ) 就 可 以 实 
例 化 和 初始 化 对 象 的 方式 。 实 例 化 对 象 时 ， 要 为 每 个 需要 初始 化 的 、 可 公开 访问 的 属性 或 字段 使 用 名 称 / 值 对 ， 
来 提供 其 值 。 其 语法 如 下 : 

<ClassName> <variableName> = new <ClassName> 


«propertyOrFieldl» = <valuel>, 
<propertyOrField2> = <value2>, 
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<propertyOrFieldN> = <valueN> 


例如 ， 重 写 前 面 的 代码 ， 实 例 化 和 初始 化 一 个 Animal 类 型 的 对 象 ， 如 下 所 示 : 
Animal animal = new Animal 
Name = "Lea", 

Age = ll, 

Weight = 30.2 


我 们 第 可 以 把 这 样 的 代码 放 在 一 行 上 ， 而 不 会 严重 影 啊 可 读 性 。 

使 用 对 象 初始 化 器 时 ， 不 必 显 式 调 用 类 的 构造 函数 。 如 果 像 上 述 代码 那样 省 略 构造 函数 的 括号 ， 就 会 自动 
调用 默认 的 无 参 构造 国 数 。 这 是 在 初始 化 器 设置 参数 值 之 表 调 用 的 ， 以 便 在 需要 时 为 默认 构造 函数 中 的 参数 提 
供 默认 值 。 另 外 ， 可 以 调用 特定 的 构造 函数 。 同 样 ， 先 调用 这 个 构造 函 数 ， 所 以 在 构造 函数 中 对 公共 属性 进行 
的 初始 化 可 能 会 被 初始 化 右 中 提供 的 值 履 新。 只 有 能 够 访问 所 使 用 的 构造 冰 数 (如 果 没 有 显 式 指出 ,就 是 默认 的 
构造 函数 )， 对 和 象 初始 化 絮 才 能 正常 工作 。 

如 果 要 用 对 象 初 妈 化 右 进 行 初 始 化 的 属性 比 本 例 中 使 用 的 简单 类 型 复杂 ， 可 以 使 用 骨 套 的 对 象 初 妈 化 器 ， 
即使 用 与 前 和 面相 同 的 语法 : 

Animal animal = new Animal 

i Name = "Rual", 

Age = "76", 

Weight = 172.7, 

Origin = new Farm 

Name = "Circle Perk Ranch", 
Location = "Ann Road", 
Rating = 15 


} 
he 


这 里 初始 化 了 一 个 Farm 类 型 (这 里 没有 列 出 ) 的 Origin 属性 。 代 人 码 初 怒 化 了 Origin 属性 的 3 个 特性 : Name. 
Location 和 Rating， 其 值 的 类 型 分 别 是 string. string 和 int。 这 个 初始 化 操作 使 用 了 内 套 的 对 象 初始 化 器 。 

注意 ， 对 象 初始 化 器 没有 替代 非 默 认 的 构造 函数 。 在 实例 化 对 象 时 ， 可 以 使 用 对 象 初始 化 器 来 设置 属性 和 
字段 值 ， 但 这 并 不 意味 看 总 是 知道 需要 初始 化 什么 状态 。 通 过 构造 函数 ， 可 以 准确 地 指定 对 象 般 要 什么 值 才 能 
起 作用 ， 上 再 执行 代码 ， 以 便 立 即 啊 应 这 些 值 。 

男 外 ， 在 上 例 中 ， 使 用 钥 套 的 对 象 初始 化 融和 使 用 构造 函数 还 有 一 个 不 太 容易 注意 到 的 区 别 : 对 象 的 
创建 顺序 。 使 用 髓 套 的 初始 化 器 时 ， 甫 先 创建 项 级 对 象 (Animal)， 然 后 创建 谋 套 对 象 (Farm)， 并 把 它 赋 值 给 
属性 Origin。 如 果 使 用 构造 图 数 ， 对 象 的 创建 顺序 融 反 了 过 来 ， 而 且 要 把 Farm 实例 传递 给 Animal 的 构造 
图 数 。 在 这 个 简单 例子 中 ， 使 用 这 两 种 方法 的 实际 效果 没什么 区 别 ， 但 在 茶 些 情况 下 它们 的 区 列 可 能 十 分 


1362 ”集合 初始 化 器 


第 $ 章 描述 了 如 何 使 用 如 下 语法 ， 用 值 来 初始 化 数组 : 

int[] myIntArray = new int[5] { 5, 9, 10, 2, 99 }; 

这 是 一 种 合并 实例 化 和 初始 化 数组 的 简捷 方式 。 集 合 初始 化 器 只 是 把 这 个 语法 扩展 到 集合 上 : 
List<int> myIntCollection = new List<int> { 5, 9, 10, 2, 99 }; 

通过 合并 对 象 和 集合 初始 化 器 ， 就 可 以 用 简洁 的 代码 来 配置 集合 了。 下 面 的 代码 : 
List<Animal> animals = new List<Animal>(); 

animals.Add(new Animal ("Donna™", 73, 116)); 


animals.Add(new Animal("Mary", 49, 132)); 
animals.Add(new Animal ("Andrea", 46, 109.1)); 
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可 以 用 如 下 代码 蔡 换 : 
List<Animal> moreAnimals = new List<Animal> 
{ 
new Animal 
{ 
Name = "Donna", 
Age = 73, 
Weight = 116 
IY 
new Animal 
{ 
Name = "Mary", 
Age = 49, 
Weight = 132 
Fe 
new Animal 
{ 
Name = "Andrea", 
Age = 46, 
Weight = 109.1 
} 
T 


这 非常 适合 于 主要 用 于 数据 表示 的 类 型 ， 因 此 ， 集 合 初始 化 器 和 本 书后 面 介绍 的 LINQ 技术 一 起 使 用 时 效 
RAE. 
下 面 的 示例 说 明了 如 何 使 用 对 象 和 集合 初始 化 器 。 


试 一 试 ” 使 用 初始 化 器 : Ch13Ex04 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex04。 

(2) 在 Solution Explorer 窗口 中 右 击 项 目 名 称 ， 选 择 Add Existing Item 选项 。 

(3) 在 C:\BeginningCSharp7\Chapter12\Ch12Ex04 目录 中 选择 Animal.cs、Cow.cs、Chicken.cs、SuperCow.cs 和 
Farm.cs Xf, "ii Add 按钮 。 

(4) 修改 所 添加 文件 中 的 名 称 空间 声明 ， 如 下 所 示 : 


namespace Chl3Ex04 


(5) 删除 Cow. Chicken 和 SuperCow 类 的 构造 图 数 。 
(6) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


static void Main(string[] args) 
{ 
FarmAnimal> farm = new Farm<Animal> 
{ 
new Cow { Name="Lea" }, 
new Chicken { Name-"Noa" ), 
new Chicken(), 
new SuperCow { Name="Andrea" } 
b: 
farm.MakeNoises(); 
ReadKey () ; 
] 
(7) 生成 应 用 程序 ， 会 得 到 如 图 13-10 所 示 的 生成 错误 。 因 为 在 Farm 类 中 没有 Add(T animal) 方 法 的 定义 。 
下 一 步 会 添加 它 。 


第 13 章 高 级 C# 技 术 | 265 


Error List 


Entire Solution - e 4 Errors | | A 0 Warnings o 0 Messages Build + Intellisense 


Nl Coue | Desuiption Project File Line Suppression State Y 


'Farm« Animal»' does not contain a definition for 'Add' and no extension method 

e CS1061 ‘Add’ accepting a first argument of type Farm«Animal*' could be found (are you Ch13Ex04 Program.cs Active 
missing a using directive or an assembly reference?) 
"Farm « Animal »' does not contain a definition for 'Add' and no extension method 

Ç C51061 ‘Add’ accepting a first argument of type 'Farm«Animal »' could be found (are you Ch13Ex04 Program.cs 
missing a using directive or an assembly reference?) 
"Farm «Animal -' does not contain a definition for 'Add' and no extension method 

ea CS1061 ‘Add’ accepting a first argument of type Farm«Animal* could be found (are you Ch13Ex04 Program.cs 
missing a using directive or an assembly reference?) 
'Farm« Animal *' does not contain a definition for ‘Add’ and no extension method 

É3 CS1061 ‘Add’ accepting a first argument of type Farm«Animal »' could be found (are you Ch13Ex04 Program.cs 
missing a using directive or an assembly reference?) 


mor list Output Find Symbol Results Breakpoints Call Hierarchy Web Publish Activity 
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(8) 给 Farm.es 添加 如 下 代码 : 
public class Farm<T> : IEnumerable<T> where T : Animal 


{ 
pt void Add(T animal) => animals.Add(animal); 


(9) 运行 应 用 程序 ， 结 果 如 图 13-11 Pra. 


示例 说 明 

这 个 示例 合并 了 对 和 象 和 集合 初始 化 融 ， 用 一 个 步骤 创建 并 填充 了 一 个 对 象 集合 。 它 使 用 前 面 章节 介绍 的 农 
场 对 象 集 合 ， 但 需要 对 用 于 这 些 类 的 初始 化 器 做 两 处 修改 。 

首先 ， 给 派生 于 Animal 基 关 的 关 删 除 构造 国 数 。 可 以 删除 这 些 构造 图 数 ， 是 因为 它们 设置 了 动物 的 Name 
属性 ， 而 这 里 使 用 对 象 初始 化 右 来 完成 。 男 外 ， 还 可 以 添加 默认 的 构造 函数 。 无 论 采 用 哪 种 方式 ， 在 使 用 默认 
的 构造 国 数 时 ， 会 根据 基 关 中 的 默认 构造 函数 来 初始 化 Name 属性 ， 代 码 如 下 : 


public Animal () 
{ 


name = "The animal with no name"; 


} 

但 是 ,对 象 初始 化 器 与 派生 于 Animal 类 的 类 一 起 使 用 时 ,初始 化 器 设置 的 任何 属性 都 在 对 象 实例 化 后 设置 
因此 在 执行 这 个 基 类 的 构造 函数 之 后 设置 。 如 果 Name 属性 的 值 作为 对 象 初始 化 器 的 一 部 分 提供 ， 这 个 值 就 会 
覆盖 默认 值 。 在 示例 代码 中 ， 为 添加 到 集合 中 的 所 有 项 设置 了 Name 属性 ， 只 有 一 项 除外 。 

其 次 ， 必 须 给 Farm 类 添加 Add0 方 法 ， 否 则 会 得 到 如 下 形式 的 一 系列 编译 错误 


"Ch13Ex04.Farm<Ch13Ex04.Animal>' does not contain a definition for 'Add' 


XX 4 ES V i da fie t VARIATE Ré. FER a, Saas ATER Woe T ss P e DTE SE D US H1 S 
合 的 AddQ 7%. Farm 类 通过 Animals 属性 提供 了 一 个 Animal XARA S VE dH AS ta XUL e BE 
Animals Add0 填 充 的 属性 ， 所 以 代码 会 失败 。 为 更 正 这 个 问题 ， 可 以 把 Add0 方 法 添加 到 类 中 ， 类 通过 对 象 初 
始 化 规 进 行 初 始 化 。 

还 可 以 修改 示例 中 的 代码 ， 为 Animals 属性 提供 一 个 民 套 的 初始 化 器 ， 如 下 所 示 : 

static void Main(string[] args) 


{ 


Farm<Animal> farm = new Farm<Animal> 


{ 


Animals = 
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Di} 


new Cow { Name="Lea" }, 
new Chicken { Name-"Noa" }, 
new Chicken(), 
new SuperCow [ Name-"Andrea" | 
) 

H 

farm.MakeNoises (); 

ReadKey () ; 

} 


有 了 此 代码 ， 就 不 需要 为 Fam 类 提供 Add0 方 法 了 。 这 个 技巧 适用 于 包含 多 个 集合 的 类 。 这 种 情况 下 ， 用 
包含 类 的 Add0 方 法 添加 的 集合 没有 其 他 蔡 代 方式 。 


13.7 ”类 型 推理 


本 书 前 面 介绍 过 C# 是 一 种 强 类 型 化 的 语言 , 这 表示 每 个 变量 都 有 固定 的 类 型 ， 只 能 用 于 接受 该 类 型 的 代码 
中 。 在 前 面 的 所 有 代码 示例 中 ， 都 采用 如 下 两 种 形式 的 代码 来 声明 变量 : 


<type> <varName>; 
<type> <varName> = <value>; 


下 面 的 代码 显示 了 变量 <varName> 的 类 型 


int myInt = 5; 
WriteLine (myInt); 


将 鼠标 指针 停放 在 变量 标识 待 上 ，IDE 融会 显示 该 变量 的 类 型 ， 如 图 13-12 所 示 。 


C£3 引入 了 新 关键 字 var， 它 可 以 蔡 代 前 面 代 码 中 的 type: 


var <VarName> = <value>; 


在 这 行 代 人 码 中 ， 变 量 <yarName> 隐 式 地 类 型 化 为 <value> 的 类 型 。 注 意 ， 类 型 的 名 称 并 不 是 var。 在 下 和 面 的 
代码 中 : 


var myVar = 5; 


my Var 是 int 类 型 的 变量 ， 而 不 是 var REWE, 如 图 13-13 Prax, IDE 也 显示 了 其 类 


这 是 非常 重要 的 一 点 。 使 用 var 时 ， 并 不 是 声明 了 一 个 没有 类 型 的 变量 ， 也 不 是 声明 了 一 个 类 型 可 变 的 变 
量 。 耕 则 ，C# 就 不 再 是 强 类 型 化 的 语言 了 。 实 际 上 ， 我 们 所 做 的 只 是 依赖 于 编译 器 来 确定 变量 的 类 型 。 

注意 : 

NET 4 引入 的 动态 类 型 扩展 了 C# 是 强 类 型 化 语言 的 定义 ， 参 见 后 面 的 13.9 节 “动态 查找 ” 。 

如 果 编 译 右 不 能 确定 用 var 声明 的 变量 类 型 ， 代 码 就 无 法 编译 。 因 此 ， 在 用 var 声明 变量 时 ， 必 须 同时 初 
始 化 该 变量 ， 因 为 如 果 没 有 初始 值 ， 编 诺 器 就 无 法 确定 变量 的 类 型 。 因 此 ， 下 面 的 代码 就 无 法 编 详 : 

Var myVar; 


var KEFE LBS 2A BI In H5 d TEE IST BLS : 
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var myArray = new[] (4, 5, 2 }; 


在 这 行 代码 中 ，myArray RASA int[].. ERA ssa EAA, MIA ash 
使 用 的 数组 元 系 必须 是 以 下 情形 中 的 一 种 : 

e 相同 的 类 型 

e 相同 的 引用 类 型 或 pull 

e ”所 有 元 素 的 类 型 剖 可 以 隐 式 地 转换 为 一 个 类 型 

如 果 应 用 最 后 一 条 规划， 元素 可 以 转换 的 类 型 就 称 为 数组 元 率 的 最 佳 类 型 。 如 果 这 个 最 佳 类 型 有 任何 含糊 
之 处 ， 即 所 有 元 素 的 类 型 都 可 以 隐 式 转换 为 两 种 或 更 多 的 类 型 ， 代 码 就 不 会 编译。 我 们 会 接收 到 错误 ， 错 误 中 
指出 没有 最 佳 类 型 ， 如 下 所 示 : 


var myArray = new[] { 4, "not an int", 2 }; 

还 要 注音 数字 值 从 来 部 不 会 解释 为 可 空 类 型 ， 所 以 下 面 的 代码 无 法 编 详 : 
var myArray = new[] { 4, null, 2 }; 

(B nf DAE Fa HER ZEHAR ir EG RAS n] AE: 


var myArray = new int?[] { 4, null, 2 Jj; 


最 后 一 点 要 说 明 的 是 ， 标 识 符 var 并 非 不 能 用 于 类 名 。 这 意味 着 ， 如 果 代码 在 其 作用 域 中 (在 同一 个 名 称 空 
间或 引用 的 名 称 空间 中 ) 有 一 个 var 类 ， 就 不 能 使 用 var 关键 字 的 隐 式 类 型 化 功能 。 

类 型 推理 功能 本 号 并 不 是 很 有 效 ， 因 为 在 本 市 前 面 的 代码 中 ， 它 只 会 使 事情 更 复杂 。 使 用 var 会 加 大 判断 
给 定 变 量 的 类 型 的 难度 。 但 如 本 章 后 面 所 述 ， 推 断 类 型 的 概念 非常 重要 ， 因 为 它 是 其 他 技术 的 基础 。 下 一 个 主 
题 是 匿名 类 型 ， 它 就 以 推断 类 型 为 基础 。 


13.8 ”匿名 类 型 


在 编写 程序 一 段 时 间 后 ， 会 友 现 我 们 要 人 花费 很 多 时 间 为 数据 表示 创建 简单 、 乏 味 的 类 ， 在 数据 库 应 用 程序 
中 尤其 如 此 。 常 党 有 一 系列 类 只 提供 属性 。 本 章 前 面 的 Animal 类 就 是 一 个 很 好 的 例子 : 
public class Animal 
{ 
public string Name { get; set; } 
public int Age { get; set; } 
public double Weight { get; set; } 
} 


这 个 类 什么 也 没 做 ， 只 是 存储 结构 化 数据 。 在 数据 库 或 电子 表格 中 ， 可 以 把 这 个 类 看 成 表 中 的 一 行 。 可 以 
保存 这 个 类 的 实例 的 集合 类 应 表示 表 或 电子 表格 中 的 多 个 行 。 

这 是 类 完全 可 以 接受 的 一 种 用 法 , 但 编写 这 些 类 的 代码 比较 单调 , 对 奔 层 数据 模式 的 任何 修改 部 需要 添加 、 
删除 或 修改 定义 类 的 代码 。 

E ARA (anonymous type) 是 简化 这 个 编程 模型 的 一 种 方式 。 其 理念 是 使 用 CHa VE i NRG ECT ia I Ba H 
动 创 建 类 型 ， 而 不 是 定义 简单 的 数据 存储 类 型 。 

可 按 如 下 方式 实例 化 前 面 的 Animal 类 型 

Animal animal = new Animal 

i Name = "Benjamin", 

Age = 42, 
7 Weight = 185.4 


也 可 以 使 用 匿名 类 型 ， 如 下 所 示 : 


Var animal = new 


{ 


Name = "Lea", 
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Age = ll, 
Weight = 30.2 
is 


这 里 有 两 个 区 别 。 第 一 ， 使 用 了 var 关键 字 。 这 十 因为 匿名 类型 没有 可 以 使 用 的 标识 待 。 稍 后 可 以 看 到 ， 
它们 在 内 部 有 一 个 标识 符 ， 但 不 能 在 代码 中 使 用 。 第 二 ， 在 new 关键 字 的 后 面 没有 指定 类 型 名 ， 这 是 编 详 器 确 
定 我 们 要 使 用 匿名 类 型 的 方式 。 

IDE 检测 到 匿名 类 型 定义 后 ， 会 相应 地 更 新 IntelliSense。 通 过 前 面 的 声明 ， 可 以 看 到 如 图 13-14 所 示 的 匿 


Var animal = new 


i 


Name - "Lea", 


[$9] (local variable) ‘a animal 


Anonymous Types: 
a is new [ string Name, int Age, double Weight } 


E] 13-14 


其 中 ， 变 量 animal 的 类 型 是 a。 显 然 ， 不 能 在 代码 中 使 用 这 个 类 型 一 一 它 甚 至 不 是 合法 的 标识 符 名 称 。' 符 
号 用 于 在 IntelliSense 中 表示 匿名 类 型 。IntelliSense 也 人 允许 查看 匿名 类 型 的 成 员 ， 如 图 13-15 所 示 。 


var animal = new 
1 
Name = "Lea", 
Age = 11, 
Weight = 38.2 
t; 
animal. N _ 
J^ Age 
? Equals 
© GetHashCode 
© GetType 
£ string a.Name { get; ] 
$^ ToStnng 
J^ Weight Anonymous Types: 
pe ‘a is new { string Name, int Age, double Weight } 


图 13-15 


注意 ， 这 里 显示 的 属性 定义 为 只 读 属性 。 这 表示 ， 如 果 要 在 数据 存储 对 象 中 修改 属性 的 值 ， 就 不 能 使 用 区 
名 类 型 。 
还 实现 了 匿名 类 型 的 其 他 成 员 ， 如 下 面 的 示例 所 示 。 


试 一 试 ”使 用 匿名 类 型 : Ch13Ex05\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 下 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex05. 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


static void Main(string[] args) 
{ 
Var animals = new[] 
{ 
new { Name 
new { Name 
new { Name 


"Benjamin", Age 
"Benjamin", Age 
n Andrea n f Age = 


42, Weight = 185 }, 
42, Weight = 185 }, 
6, Weight = 109 } 


= il il 


WriteLine (animals[0] .ToString()); 
WriteLine (animals[0] .GetHashCode()); 
WriteLine(animals[1].GetHashCode()); 
WriteLine (animals[2] .GetHashCode()); 
WriteLine (animals[0] .Equals (animals[1])); 
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WriteLine (animals [0] .Equals (animals[2])); 
WriteLine (animals [0] animals[1]); 
WriteLine (animals[0] animals [2]); 
ReadKey () ; 

} 


(3) 运行 应 用 程序 ， 结 果 如 图 13-16 所 示 。 


13-16 


示例 说 明 
这 个 示例 创建 了 一 个 匿名 类 型 对 象 的 数组 ， 然 后 使 用 它 测试 匿名 类 型 提供 的 成 员 。 创 建 匿 
组 的 代码 如 下 : 


Var animals = new[] 
{ 
new { Name = "Benjamin", Age = 42, Weight = 185 }, 


名 类 型 对 象 的 数 


he v 
这 段 代 码 通 过 本 节 和 和 前面“ 类 型 推理 ”一 节 中 介绍 的 语法 ， 使 用 了 隐 式 类 型 化 为 匿名 类 型 的 数组 。 结 果 是 
animals 变量 包含 3 个 匿名 类 型 的 实例 。 
创建 这 个 数组 后 ， 代 码 首 先 得 出 在 匿名 类 型 上 调用 ToString0 的 结果 : 
WriteLine (animals[0].ToString()); 
输出 结果 如 下 : 
{ Name = Benjamin, Age = 42, Weight = 185 } 
匿名 类 型 上 的 Tostring0 的 实现 输出 了 为 该 类 型 定义 的 每 个 属性 的 值 。 
接 厦 ， 代 码 在 数组 的 3 个 对 象 上 分 别 调用 GetHashCode(): 


WriteLine (animals[0].GetHashCode()); 
WriteLine (animals[1].GetHashCode()); 
WriteLine (animals [2] .GetHashCode()); 


GetHashCode0 执 行 时 ， 应 根据 对 象 的 状态 为 对 象 返 回 一 个 唯一 的 整数 。 数 组 中 的 前 两 个 对 象 有 相同 的 属性 
值 ， 所 以 其 状态 是 相同 的 。 这 些 调用 的 结果 是 前 两 个 对 象 的 整数 相同 ， 第 三 个 对 象 的 至 数 不 同 。 结 果 如 下 : 


1148883016 
1148883016 
1315536032 


接着 调用 Equals0 方 法 比较 第 一 个 对 象 和 第 二 个 对 象 ， 再 比较 第 一 个 对 象 和 第 三 个 对 象 


WriteLine (animals[0].Equals(animals[1])); 
WriteLine (animals [0] .Equals (animals[2])); 


结果 如 下 : 


True 
False 


匿名 类 型 上 的 EqualsO 的 实现 比较 对 象 的 状态 , MRAR RRA BES JS PEE B3 3 — T 8] Be YJ PE ED 
相同 ， 结 果 就 是 true。 

但 使 用 一 运算 和 从 不 会 得 到 这 样 的 结果 。 如 前 几 半 所 述 ， 一 运算 和 从 比较 对 象 引 用 。 最 后 一 部 分 代码 执行 与 上 
一 段 代 码 相 同 的 比较 ， 但 用 二 蔡 代 了 Equals0 方 法 : 


WriteLine(animals[0] == animals[11):; 
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WriteLine(animals[0] == animals[2]); 
animals 224 FIN — DAB 5 | F3 EE 4 AINA [n] Sc], 所 以 在 两 种 情况 下 结果 都 是 false. 输出 结果 与 预期 的 
相同 : 


False 
False 


有 趣 的 是 ， 在 创建 匿名 类 型 的 实例 时 ， 编 详 如 会 注音 到 ， 参 数 吓 相同 的 ， 所 以 创建 同一 个 匿名 类 型 的 3 个 
实例 一 一 而 不 是 3 个 不 同 的 匿名 类 型 。 但 是 ， 这 并 不 意味 着 实例 化 匿名 类 型 的 对 象 时 ， 编 详 器 会 得 找 匹 配 的 类 
型 。 即 使 在 其 他 地 方 定义 了 一 个 有 匹配 属性 的 类 ， 如 果 使 用 了 匿名 类 型 语法 ， 也 只 创建 (或 重用 ， 如 本 例 所 示 ) 
一 个 匿名 关 型 。 


13.9 ”动态 查找 


如 前 所 述 ，var 关键 字 本 号 并 不 是 一 个 类 型 ， 所 以 并 没有 违反 C# 的 “ 强 类 型 化 ”方法 论 。 但 从 C#4 开始， 
一 些 地 方 变 得 没 那么 死板 。C# 4 引入 了 “动态 变量 ”的 概念 ， 顾 名 思 义 ， 动 态 变 量 是 类 型 可 变 的 变量 。 

引入 动态 变量 的 主要 目的 是 在 许多 情况 下 , 希望 使 用 C# 人 处 理 男 一 种 语言 创建 的 对 象 。 这 包括 与 旧 技 术 的 交 
互 操作 ， 例 如 Component Object Model(COM)， 也 包括 处 理 动态 语言 ， 例 如 JavaScript. Python 和 Ruby。 这 里 
不 详细 讨论 其 实现 细节 ， 只 需要 知道 , 过 去 使 用 C# 访 问 这 些 语言 所 创建 的 对 象 的 方法 和 属性 需要 用 到 稚 拙 的 语 
法 。 例 如 ， 假 定 代 码 从 JavaScript 中 获得 一 个 市 Add0 方 法 的 对 象 ， 该 方法 把 两 个 数字 加 在 一 起 。 如 果 没 有 动态 
伍 找 功能 ， 调 用 这 个 方法 的 代码 就 如 下 所 示 : 


ScriptObject jsObj = SomeMethodThatGetsTheObject (); 
int sum = Convert.ToInt32(jsObj.Invoke("Add", 2, 3)); 


ScriptObject 类 型 (这 里 不 深入 探讨 ) 提 供 了 一 种 访问 JavaScript 对 象 的 方式 ， 但 仍 不 能 执行 如 下 操作 : 

int sum = jsObj.Add(2, 3); 

动态 查找 功能 改变 了 这 一 切 ， 它 允许 编写 上 述 代码 ， 但 如 下 面 几 节 所 述 ， 这 个 功能 是 有 代价 的 。 

男 一 个 可 使 用 动态 查找 功能 的 情形 是 处 理 未 知 类 型 的 C# 对 象 。 这 听 起 来 似乎 很 古怪 , 但 这 种 情形 出 现 的 次 
数 比 我 们 想象 得 多 。 如 果 需 要 编写 一 些 泛 型 代码 来 处 理 接收 的 各 种 输入 ， 这 也 是 一 项 重要 功能 。 处 理 这 种 情形 
的 “ 旧 ” 方 法 称 为 “反射 Ceflection)”， 它 涉及 使 用 类 型 信息 来 访问 类 型 和 成 员 。 前 一 章 使 用 了 简单 的 反射 来 访 
问 与 类 型 关联 的 特性 。 使 用 反射 访问 类 型 成 员 ( 如 方法 ) 的 语法 非 第 类 似 于 上 述 代 码 中 访问 JavaScript 对 象 的 语 
iE, THAR ARI. 

在 后 台 , 动态 查找 功能 由 Dynamic Language Runtime( 动 态 语言 运行 库 ，DLR) 支 持 。 与 CLR 一 样 , DLR 
是 .NET 4.7 的 一 部 分 。DLR 的 精确 描述 及 其 如 何 简化 交互 操作 超出 了 本 书 的 讨论 范围 ， 这 里 仅 对 如 何在 C# 中 
使 用 它 感 兴趣 。 有 关 DLR INE SAR, 可 以 参阅 https://docs.microsoft.com/en-us/dotnet/framework/reflection-and- 
codedom/dynamic-language-runtime-overview. 


C# 4 引入 了 dynamic 关键 字 ， 以 用 于 定义 变量 。 例 如 : 

dynamic myDynamicVar; 

与 前 面 介绍 的 var 关键 字 不 同 ， 的 确 存 在 动态 类 型 ， 所 以 在 声明 myDynamicVar 时 ， 不 必 初 始 化 它 的 值 。 

注意 : 

动态 类 型 的 不 同 寻 种 之 处 在 于 ， 它 仅 在 编译 期 间 存在 ， 在 运行 期 间 它 会 被 System.Object 类 型 替代 。 这 是 较 
细微 的 实现 细节 ， 但 必须 记 住 这 一 点 ， 因 为 这 可 能 澄清 了 后 面 的 一 些 讨 论 . 
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一 旦 有 了 动态 变量 ， 就 可 以 继续 访问 其 成 员 ( 这 里 没有 列 出 实际 获取 变量 值 的 代码 )。 
myDynamicVar.DoSomething ("With this!"); 


无 论 myDynamicVar 实际 包含 什么 值 ， 这 行 代 人 码 都 会 编译 。 但 是 ， 如 果 所 请 求 的 成 员 不 存在 ， 在 执行 这 行 
代码 时 会 生成 一 个 RuntimeBinderException 类 型 的 异常。 

实际 上 ， 像 这 样 的 代码 提供 了 一 个 应 在 运行 期 间 应 用 的 “处 方 ”。 检 查 myDynamicVar 的 值 ， 找 到 市 一 个 字 
符 串 参数 的 DoSomething0 方 法 ， 并 在 需要 时 调用 它 。 

这 最 好 举例 说 明 。 


警告 
下 面 的 示例 仅 用 于 演示 ! 一 般 情况 下 ， 应 仅 在 动态 类 型 是 唯一 选项 时 才 使 用 它们 ， 例 如 处 理 非 .NET 对象 。 


试 一 试 ”使 用 动态 类 型 : Ch13Ex06\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex06. 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

using System. Threading.Tasks; 

using Microsoft.CSharp.RuntimeBinder; 
using static System.Console; 
namespace Chl3Ex06 


{ 
class MyClass1 
{ 
public int Add(int varl, int var2) => varl + var2; 
} 


class MyClass2 {} 
class Program 


{ 
static int callCount = 0; 
static dynamic GetValue () 
{ 
if (callCount++ == 0) 
{ 
return new MyClass1 (); 
} 
return new MyClass2(); 
} 
static void Main(string[] args) 
{ 
try 
{ 
dynamic firstResult = GetValue () ; 
dynamic secondResult = GetValue(); 
WriteLine($"firstResult is: (firstResult.ToString())"); 
WriteLine($"secondResult is: {secondResult.ToString()}"); 
WriteLine($"firstResult call: {firstResult.Add(2, 3)}"); 
WriteLine($"secondResult call: {secondResult.Add(2, 3)}"); 
catch (RuntimeBinderException ex) 
{ 
WriteLine (ex.Message) ; 
} 
ReadKey () ; 
} 
} 


} 
(3) 运行 应 用 程序 ， 结 果 如 图 13-17 所 示 。 
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示例 说 明 

这 个 示例 使 用 一 个 方法 返回 两 个 类 型 的 对 象 中 的 一 个 ， 以 获取 动态 值 ， 青 尝试 使 用 所 获取 的 对 象 。 代 码 在 
编译 时 没有 遇 到 任何 问题 ， 但 笃 试 访问 不 存在 的 方法 时 ， 抛 出 (并 处 理 ) 了 一 个 异 第 。 

H^c. AAA RuntimeBinderException 异常 的 名 称 空间 添加 一 条 using 语句 : 

using Microsoft.CSharp.RuntimeBinder; 

接着 定义 两 个 类 : MyClassl 和 MyClass2, eA MyClass] 包含 Add0 方 法 ， 而 MyClass2 不 合成 员 : 


class MyClassl 
{ 


} 
class MyClass2 { } 


public int Add(int varl, int var2) => varl + var2; 


还 要 给 Program 类 添加 一 个 字段 (callCount) 和 一 个 方法 (GetValue0)， 以 获取 其 中 一 个 类 的 实例 : 


static int callCount = 0; 
static dynamic GetValue () 


if (callCount++ == 0) 
{ 

return new MyClassl(): 
} 


return new MyClass2(); 


} 


使 用 一 个 简单 的 调用 计数 器 ， 这 样 ， 第 一 次 调用 这 个 方法 时 ， 返 回 MyClass] 的 一 个 实例 ， 之 后 返回 
MyClass2 的 一 个 实例 。 注 意 dynamic 关键 字 可 用 作 方 法 的 返回 类 型 。 
接 痢 ，Main0 中 的 代码 调用 Getvalue0 方 法 两 次 ， 再 答 试 在 返回 的 两 个 值 上 依次 调用 GetString0 和 AddQ. 
这 些 代码 放 在 try … catch 块 中 ， 以 捕获 可 能 发 生 的 RuntimeBinderException 2378 [] FE T o 
static void Main(string[] args) 
{ 
try 
{ 
dynamic firstResult = GetValue(); 
dynamic secondResult = GetValue(); 
WriteLine($"firstResult is: {firstResult.ToString()}"); 
WriteLine($"secondResult is: {secondResult.ToString()}"); 
WriteLine($"firstResult call: [firstResult.Add(2, 3)]"); 
WriteLine ($"secondResult call: [secondResult.Add(2, 3)]"): 


catch (RuntimeBinderException ex) 
{ 
WriteLine(ex.Message); 
} 
ReadKey (); 


可 以 肯定 ， 调 用 secondResultAdd0 时 会 抛 出 一 个 异常 ， 因 为 在 MyClass2 上 不 存在 这 个 方法 。 异 常 消 息 说 
明了 这 一 点 。 
dynamic 关键 字 也 可 用 于 其 他 需要 类 型 名 的 地 方 ， 例 如 方法 参数 。Add0 方 法 可 以 重 写 为 : 
public int Add(dynamic varl, dynamic var2) => varl + var2; 
这 对 结果 没有 任何 影响 。 在 这 个 例子 中 ， 传 送 给 varl 和 var2 的 值 在 运行 期 间 检查 ， 以 确定 加 号 + 是 否 存在 
ARRERA EA. WIRE SPAS int 值 ， 束 存在 这 样 的 运算 待 。 如 果 使 用 了 不 兼容 的 值 ， 就 抛 出 
RuntimeBinderException Fis. Plan, WRIN: 
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WriteLine ("firstResult call: {0}", firstResult.Add("2", 3)); 

异 币 消息 融 如 下 所 示 : 

Cannot implicitly convert type 'string' to 'int' 

从 这 里 获得 的 教训 是 动态 类 型 是 非常 强大 的 ， 但 有 一 个 敬告。 如 果 用 强 关 型 代 蔡 动态 类 型 ， 束 完全 可 以 避 
免 抛 出 这 些 异 利 。 对 于 大 多 数目 己 编 与 的 C# 代 码 ， 应 避免 使 用 dynamic 关键 字 。 但 是 ， 如 果 和 需要 使 用 它 ， 就 应 
使 用 它 ， 并 会 路 欢 上 它 一 一 而 不 像 过 去 那些 可 怜 的 程 订 员 那样 没有 这 个 强大 的 工具 可 用 。 


13.10 ”高 级 方法 参数 


C#4 扩 展 了 定义 和 使 用 方法 参数 的 方式 。 这 主要 是 为 了 啊 应 使 用 外 部 定义 的 接口 时 出 现 的 一 个 特殊 问题 ， 
例如 Microsoft Office 编程 模型 。 其 中 ， 一 些 方法 有 大 量 参数 ， 许 多 参数 并 不 是 每 次 调用 都 需要 的 。 过 去 ， 这 意 
味 着 需要 一 种 方式 指定 缺失 的 参数 ， 否 则 在 代码 中 会 出 现 许多 空 值 ; 

RemoteCall(varl, var2, null, null, null, null, null); 

在 这 行 代码 中 ，null 值 表示 什么 并 不 明显 ， 或 者 它们 为 什么 省 略 并 不 清楚 。 

了 也许， 理想 情况 下 ， 这 个 RemoteCall0 方 法 有 多 个 重 载 版 本 ， 其 中 一 个 重 载 版 本 仪 需 要 两 个 参数 : 


RemoteCall(varl, varz); 


但 是 ， 这 需要 更 多 带 其 他 参数 组 合 的 方法 ， 这 本 身 台 会 市 来 更 多 问题 (要 维护 更 多 的 代码 ， 增 加 了 代码 复杂 
程度 等 )。 
Visual Basic 等 语言 以 妨 一 种 方式 处 理 这 种 情况 ， 即 允许 使 用 命名 参数 和 可 选 参数 。 从 C# 4 版 本 开始 ，C# 
中 也 允许 这 样 做 ， 这 是 所 有 .NET 语言 的 演 omm 
下 面 几 市 介绍 如 何 使 用 这 些 新 的 参数 类 


13.10.1 可 选 参 数 


调用 方法 时 ， 第 给 示 个 参数 传 入 相同 的 值 。 例 如 ， 这 可 能 是 一 个 布尔 值 ， 以 控制 方法 操作 中 的 不 重要 部 分 。 
具体 而 言 ， 考 虑 下 面 的 方法 定义 : 


public List<string> GetWords(string sentence, bool capitalizeWords) 


{ 


} 

无 论 给 capitalizeWords 参数 传 入 什么 值 ， 这 个 方法 都 会 返回 一 系列 string 值 ， 每 个 string (Babe MA ajy P 
的 一 个 单词 。 根 据 这 个 方法 的 使 用 方式 ， 可 能 需要 把 返回 的 单词 列表 转换 为 大 写 ( 也 许 要 格式 化 一 个 标题 )。 但 
大 多 数 情况 下 并 不 需要 这 人 么 做 ， 所 以 大 多 数 调用 如 下 所 示 : 

List<string> words = GetWords (sentence, false); 

AI FER AEM “ERA” FTN, BLAH RPE, GOR Am: 

public List<string> GetWords (string sentence) => GetWords (sentence, false); 

这 个 方法 调用 第 二 个 方法 ， 并 给 capitalize Words 传 入 值 false. 

这 么 做 没有 任何 错误 ， 但 可 以 想象 在 使 用 更 多 的 参数 时 ， 这 种 方式 会 非常 复 林 。 

男 一 种 方式 是 把 capitalizeWords 参数 变 成 可 选 参数 。 这 需要 在 方法 定义 中 为 参数 所 供 一 个 默认 值 ， 使 其 成 
为 可 选 参数 ， 如 果 调 用 此 方法 时 没有 为 该 参数 提供 值 ， 束 使 用 默认 值 ， 如 下 所 示 : 


public List<string> GetWords(string sentence, bool capitalizeWords = false) 


pre 
GRAM TT EIT, bu] LAGER T EXPST AG AA capitalizeWords 是 true 时 ， 才 需要 第 二 
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1. 可 选 参数 的 值 
如 上 一 节 所 述 ， 为 方法 定义 可 选 参 数 的 语法 如 下 所 示 : 


<parameterType> <parameterName> = <defaultValue> 

对 于 <defaultvalue> 的 默认 值 ， 存 在 一 些 限 制 。 鸭 认 值 必须 是 字面 值 、 钊 量 值 或 者 款 认 值 关 型 值 。 因 此 不 会 
编译 下 和 面 的 代码 : 

public bool CapitalizationDefault; 

public List<string> GetWords (string sentence, 


bool capitalizeWords - CapitalizationDefault) 
{ 


Lan 

为 使 上 述 代码 可 以 工作 ，CapitalizationDefault (E VAE NAH 8 : 

public const bool CapitalizationDefault = false; 

这 样 做 是 否 有 意义 取决 于 具体 情 形 ， 大 多 数 情况 下 ， 最 好 提供 一 个 字面 值 ， 就 像 上 一 节 那 样 。 

2. Optional 特性 

除了 前 面 小 节 中 描述 的 语法 ， 还 可 以 使 用 Optional 特性 定义 可 选 参数 ， 如 下 所 示 : 

[Optional] <parameterType> <parameterName> 

此 特性 包含 在 System.Runtime.InteropServices 名 称 空 间 中 。 注 意 ， 如 果 使 用 这 种 语法 ， 束 无 法 为 参数 提供 
默认 值 。 


3. 可 选 参 数 的 顺序 
使 用 可 选 值 时 ， 它 们 必须 位 于 方法 的 参数 列表 未 尾 。 没 有 默认 值 的 参数 不 能 放 在 有 默认 值 的 参数 后 面 。 
因此 下 面 的 代码 是 非法 的 ; 


public List<string> GetWords (bool capitalizeWords = false, string sentence) 


} see 
ELH, sentence 是 必 选 参数 ， 因 此 必须 放 在 可 选 参数 capitalizedWords 的 前 面 。 


13.10.2 命名 参数 


使 用 可 选 参数 时 ， 可 能 发 现 某 个 方法 有 几 个 可 选 参数 ， 但 可 能 只 想 给 第 三 个 可 选 参数 传递 值 。 从 上 一 节 介 
绍 的 语法 看 ， 如 琳 不 提供 前 两 个 可 选 参 数 的 值 ， 就 无 法 给 第 三 个 可 选 参数 传递 值 。 

命名 参数 (named parameters) 人 允许 指定 要 使 用 哪个 参数 。 这 不 需要 在 方法 定义 中 进行 任何 特殊 处 理 ， 它 是 一 
种 在 调用 方法 时 使 用 的 技术 。 其 语法 如 下 : 


MyMethod ( 
«paramlName-: «paramlValue-, 


«paramNName»: «paramNValue»); 
参数 的 名 称 是 在 方法 定义 中 使 用 的 变量 名 。 
只 要 命名 参数 人 存在， 就 可 以 采用 这 种 方式 指定 需要 的 任意 多 个 参数 ， 而 且 参 数 的 顺序 是 任意 的 。 命 名 参数 
也 可 以 是 可 选 的 。 
可 以 仅 给 方法 调用 中 的 东 些 参数 使 用 命名 参数 。 当 方法 签名 中 有 多 个 可 选 参 数 和 一 些 必 选 参数 时 ， 这 和 是非 
利 有 用 的 。 可 以 首先 指定 必 选 参数 ， 再 指定 命名 的 可 选 参数 。 例 如 : 
MyMethod ( 


requiredParameterlValue, 
optionalParameter5: optionalParameter5Value); 


但 注意 ， 如 果 混 合 使 用 命名 参数 和 位 置 参数 ， 束 必须 先 包含 所 有 的 位 置 参 数 ， 其 后 是 命名 参数 。 但 是 ， 只 
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要 全 部 使 用 命名 参数 ， 参 数 的 顺序 也 可 以 不 同 。 例 如 : 


MyMethod ( 
optionalParameter5: optionalParameter5Value, 
requiredParameterl: requiredParameterlValue); 


下 面 的 示例 介绍 了 如 何 使 用 命名 参数 和 可 选 参数 。 


试 一 试 使 用 命名 参数 和 可 选 参数 : Ch13Ex07 


(1) 在 目录 C:\BeginningCSharp7\Chapter13 中 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex07. 
(2) 在 项 目 中 添加 一 个 类 WordProcessor， 修 改 其 代码 ， 如 下 所 示 : 


public static class WordProcessor 
{ 
public static List<string> GetWords ( 
string sentence, 
bool capitalizeWords = false, 
bool reverseOrder = false, 
bool reverseWords false) 


List<string> words = new List<string>(sentence.Split(' ')); 
if (capitalizeWords) 
words = CapitalizeWords (words) ; 
if (reverseOrder) 
words = ReverseOrder (words) ; 
if (reverseWords) 
words = ReverseWords (words) ; 
return words; 
} 
private static List<string> CapitalizeWords (List<string> words) 
{ 
List<string> capitalizedWords = new List<string>(); 
foreach (string word in words) 
{ 
if (word.Length == 0) 
continue; 
if (word.Length == 1) 
capitalizedWords . Add ( 
word[0] .ToString() .ToUpper () ) ; 
else 
capitalizedWords.Add( 
word[0] .ToString() .ToUpper () 
+ word.Substring(1)); 
} 
return capitalizedWords; 
} 
private static List<string> ReverseOrder (List<string> words) 
{ 
List<string> reversedWords = new List<string>(); 
for (int wordIndex = words.Count - 1; 
wordIndex >= 0; wordIndex--) 
reversedWords .Add (words [wordIndex]) ; 
return reversedWords; 
} 
private static List<string> ReverseWords (List<string> words) 
{ 
List<string> reversedWords = new List<string>(); 
foreach (string word in words) 
reversedWords .Add (ReverseWord (word) ) ; 
return reversedWords; 
} 
private static string ReverseWord (string word) 
{ 
StringBuilder sb = new StringBuilder () ; 
for (int characterIndex = word.Length - 1; 
characterIndex >= 0; characterIndex--) 
sb.Append (word[characterIndex]) ; 
return sb.ToString(); 
} 
} 


(3) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 
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static void Main(string[] args) 
{ 
string sentence = "his gaze against the sweeping bars has " 
+ "grown so weary"; 
List<string> words; 
words = WordProcessor .GetWords (sentence); 
WriteLine ("Original sentence:"); 
foreach (string word in words) 
{ 
Write (word) ; 
Write(' '); 
} 
WriteLine('\n'); 
words = WordProcessor.GetWords ( 
sentence, 
reverseWords: true, 
capitalizeWords: true); 
WriteLine("Capitalized sentence with reversed words:"); 
foreach (string word in words) 
{ 
Write (word) ; 
Write(' '); 
} 
ReadKey () ; 
} 


(4) 运行 应 用 程序 ， 结 果 如 图 13-18 所 示 。 


示例 说 明 
这 个 示例 创建 了 一 个 执行 一 些 简 单 的 字符 串 处 理 的 实用 类 ， 和 再 使 用 这 个 类 修改 一 个 字符 种。 类 中 的 单个 公 
共 方 法 包含 1 个 必 选 参数 和 3 个 可 选 参数 : 
public static List<string> GetWords ( 
string sentence, 
bool capitalizeWords = false, 
bool reverseOrder = false, 


bool reverseWords = false) 


{ 
} 
这 个 方法 返回 string 值 的 一 个 集合 ， 每 个 string 值 都 是 初始 输入 的 一 个 单词 。 根 据 指定 的 可 选 参数 ， 可 能 
会 进行 额外 的 转换 ， 对 字符 串 集合 进行 整体 转换 ， 或 者 仅 转换 某 个 单词 。 


注意 : 
这 里 并 未 深入 探讨 WordProcessor 类 的 功能 ， 读 者 可 以 自己 研究 它 的 代码 ， 考 虑 一 下 如 何 改进 这 些 代码 ， 
例如 his 应 改 为 His "Ej? 如 何 进行 这 个 修改 ? 


调用 这 个 方法 时 ， 只 使 用 了 两 个 可 选 参数 ， 第 三 个 参数 (reverseOrdeD) 使 用 其 默认 值 false: 
words = WordProcessor.GetWords ( 
sentence, 
reverseWords: true, 
capitalizeWords: true); 


还 要 注意 ， 所 指定 的 两 个 参数 的 顺序 与 定义 它们 的 顺序 不 同 。 
最 后 要 注意 ， 处 理 珊 有 可 选 参数 的 方法 时 ， 使 用 IntelliSense 会 非 芝 方便 。 输 入 这 个 示例 的 代码 时 ， 注 总 
GetWords0 方 法 的 工具 提示 ， 如 图 13-19 所 示 ( 把 鼠标 指针 停放 在 方法 调用 上 ， 也 会 看 到 这 个 工具 提示 )。 


第 13 章 高 级 C# 技 术 | 277 


Pra gram.cs 2 X 
国 Ch13Ex07 
= US - 


using System; 
using $ d stem.Collections.Ge 
ing 5 .Ling; 


using 5ystem.Threading.Ta : 
using iiti Scip: Cosa e; 


space Ch13Ex87 
ass Program 
static void Main(string[] args) 


string sentence = "his gaze against e sweepin a 
"Egrown so weary"; 
List&string» words; 
words = WordProcessor.GetWerds(semtence): 
Writeline("Original sentence:"); 
foreach (string word in words) 
i 
Write(word); 
Write(' '); 


WriteLine('in'); 

words - WordProcessor.GetWords( 
sentence, 
reverseWords: true, 
capitalizeWords: true); 


© List<string> WordProcessorcGetWords(string sentence, [bool capitalizeWords = false], [bool reverseOrder = false], [bool reverseWords = false] 
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13.11 Lambda 表达 式 


Lambda 表达 式 是 一 种 结构 ， 可 用 于 人 简化 C# 编 程 的 条 些 方面 ， 在 与 LINQ 结合 使 用 时 尤为 方便 。Lambda 
表达 式 一 开始 很 难 擎 握 ， 主 要 是 因为 其 用 法 非常 灵活 。Lambda 表达 式 与 其 他 C# 语 言 特性 (如 匿名 方法 ) 结 合 使 
用 时 极其 有 用 。 由 于 本 书后 面 才 介绍 LINQ， 因 此 匿名 方法 是 介绍 Lambda 表达 式 的 最 佳 切入 点 。 下 面 首 先 快速 
回顾 一 下 匿名 方法 。 


13.11.1 复习 匿名 方法 


本 章 前 面 学 习 了 匿名 方法 ， 这 是 提供 的 内 联 (nline) 方 法 ， 否 则 就 需要 使 用 委托 类 型 的 变量 。 给 事件 添加 处 
理 程序 时 ， 过 程 如 下 : 

(D) 定义 一 个 事件 处 理 方法 ， 其 返回 类 型 和 参数 匹配 要 订阅 的 事件 需要 的 委托 的 返回 类 型 和 参数 。 

(2) 声明 一 个 委托 类 型 的 变量 ， 用 于 事件 。 

(3) 把 委托 变量 初始 化 为 委托 类 型 的 实例 ， 该 实例 指 癌 事件 处 理 方法 。 

(4) 把 委托 变量 添加 到 事件 的 订阅 者 列表 中 。 

实际 上 ， 这 个 过 程 会 比 上 述 简 单一 些 ， 因 为 一 般 不 使 用 变量 来 存储 委托 ， 只 在 订阅 事件 时 使 用 委托 的 一 个 
实例 。 

前 面 使 用 的 代码 束 属 于 这 种 情况 ， 如 下 所 示 : 


Timer myTimer = new Timer(100); 
myTimer.Elapsed += new ElapsedEventHandler (WriteChar); 


这 段 代 码 订 向 了 Timer 对 象 的 Elapsed 事件 。 这 个 事件 使 用 委托 类 型 ElapsedEventHandler， 使 用 方法 标 
RIF WriteChar 实例 化 该 委托 类 型 。 结 果 是 Timer 对 象 引 发 Elapsed 事件 时 ， 就 调用 方法 WriteCharQ. 3525 
WriteChar0 的 参数 取决 于 由 ElapsedEventHandler 委托 定义 的 参数 类 型 和 Timer 中 引发 事件 的 代码 传递 的 值 。 

实际 上 ， C# 编 译 右 可 以 通过 方法 组 语法 ， 用 更 少 的 代码 获得 相同 的 结果 : 


myTimer.Elapsed += WriteChar; 


CHin Far ANE Elapsed 事件 需要 的 委托 类 型 ， 所 以 可 以 填充 该 类 型 。 但 大 多 数 情况 下 ， 最 好 不 要 这 么 做 ， 
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因为 这 会 使 代码 更 难 理解 ， 也 不 清楚 会 发 生 什 么 。 使 用 匿名 方法 时 ， 该 过 程 会 减少 为 “一 步 ” 
(1) 使 用 内 联 的 匿名 方法 ， 该 匿名 方法 的 返回 类 型 和 参数 匹配 所 订阅 事件 需要 的 委托 的 返回 类 型 和 参数 。 
用 delegate 关键 字 定 义 内 联 的 匿名 方法 : 


myTimer.Elapsed += 
delegate (object source, ElapsedEventArgs e) 


WriteLine("Event handler called after {0} milliseconds.", 
(source as Timer).Interval); 
H 
这 段 代 码 像 单独 使 用 事件 处 理 程序 一 样 正常 工作 。 主 要 区 别 是 这 里 使 用 的 匿名 方法 对 于 其 余 代码 而 言 实际 
上 是 隐藏 的 。 例 如 ， 不 能 在 应 用 程序 的 其 他 地 方 重 用 这 个 事件 处 理 程序 。 男 外 ， 为 更 好 地 加 以 搬 述 ， 这 里 使 用 
MINEA MUL]. delegate 关键 字 会 市 来 泥 洒 ， 因 为 它 具 有 双重 含义 一 一 匿名 方法 和 定义 委托 类 型 都 要 使 用 它 。 


13.11.2 把 Lambda 表达 式 用 于 匿名 方法 


下 面 看 一 下 Lambda 表达 式 。Lambda 表达 式 是 简化 匿名 方法 的 语法 的 一 种 方式 。 实 际 上 ，Lambda 表达 式 
还 有 其 他 用 处 ， 但 为 了 简单 起 见 ， 本 节 只 介绍 Lambda 表达 式 的 这 个 方面 。 使 用 Lambda 表达 式 可 以 重 写 上 一 
节 最 后 的 一 段 代码 ， 如 下 所 示 : 


myTimer.Elapsed += (source, e) => WriteLine("Event handler called after " + 
S"{ (source as Timer).Interval] milliseconds."); 


IES WA LEA ALLA BRA SK A (GRAF RACE ATI FIER C RE a» W Lisp 或 Haskell). fH] 4f 
AWS, La oh Bk Bb ES Bem TEIN, E EPTEHNITIEEAAZIHEHTT AR. Lambda 表达 式 由 以 
下 3 个 部 分 组 成 : 

e 放 在 括号 中 的 参数 列表 (未 类 型 化 ) 

e =>j28 

e CHE) 

使 用 本 和 童 前 面 “ 匿 名 类 型 ”一 节 中 介绍 的 逻辑 ， 从 上 下 文中 推 新 出 参数 的 关 型 。 僵 运 得 符 只 是 把 参数 列表 
与 表达 式 体 分 开 。 在 调用 Lambda 表达 式 时 ， 执 行 表达 式 体 。 

编 详 器 会 提取 这 个 Lambda 表达 式 ， 创 建 一 个 匿名 方法 ， 其 工作 方式 与 上 一 节 中 的 匿名 方法 相同 。 其 实 ， 
它 会 被 编译 为 相同 或 相似 的 CIL 代码 。 

为 说 明 Lambda 表达 式 中 的 内 容 ， 下 面 列举 一 个 例子 。 


试 一 试 ” 使 用 简单 的 Lambda 表达 式 : Ch13Ex08\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 从 应 用 程序 Ch13Ex08。 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


namespace Ch13Ex08 


delegate int TwoIntegeroOperationDelegate (int paramA, int paramB) ; 
class Program 
{ 
static void PerformOperations (TwoIntegerOperationDelegate del) 
{ 
for (int paramAVal — 1; paramAVal <= 5; paramAVal++) 
{ 


for (int paramBVal = 1; paramBVal <= 5; paramBVal++) 
{ 


int delegateCallResult = del (paramAVal, paramBVal) ; 
Write ($"f({paramAVal}, " + 
$"{paramBVal})={delegateCallResult}") ; 
if (paramBVal != 5) 
{ 
Write(", "); 
) 


} 
WriteLine (); 
} 
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} 

static void Main(string[] args) 

{ 
WriteLine("f(a, b) = a + b:"); 
PerformOperations((paramA, paramB) => paramA + paramB) ; 
WriteLine (); 
WriteLine("f(a, b) =a * b:"); 
PerformOperations((paramA, paramB) => paramA * paramB) ; 
WriteLine(); 
WriteLine("fí(a, b) = (a - b) $ b:"); 
PerformOperations((paramA, paramB) => (paramA - paramB) 

*$ paramB); 

ReadFey () ; 

} 

} 
} 


(3) 运行 应 用 程序 ， 结 果 如 图 13-20 所 示 。 


示例 说 明 

这 个 示例 使 用 Lambda 表达 式 生 成 函数 ， 用 来 在 两 个 输入 参数 上 执行 指定 的 处 理 ， 并 返回 结果 。 接 看 这 些 
图 数 操作 25 对 值 ， 把 结 末 输出 到 控制 合 上。 

首先 定义 一 个 委托 类 型 TwoIntegerOperationDelegate， 表 示 一 个 方法 ， 该 方法 有 两 个 int 参数， 返回 一 个 int 
结果 : 

delegate int TwoIntegerOperationDelegate(int paramA, int paramB); 

在 以 后 定义 Lambda 表达 式 时 可 使 用 这 个 委托 类 型 。 这 些 Lambda 表达 式 编译 为 方法 ， 其 返回 类 型 和 参数 
匹配 这 个 委托 类 型 ， 如 稍 后 所 述 。 

BUB UST; 14 PerformOperations); "15 fi— | TwolntegerOperationDelegate 类 型 的 参数 : 


static void PerformOperations (TwoIntegerOperationDelegate del) 


{ 
这 个 方法 的 含义 是 ， 可 给 它 传递 一 个 朗 托 实例 (或 者 匿名 方法 ， 或 者 Lambda RIA, AAEM ihe Sa 
译 为 委托 实例 )， 该 方法 会 用 一 组 值 调用 委托 实例 所 表示 的 方法 : 
for (int paramAVal = 1; paramAVal <= 5; paramAVal++) 


{ 
for (int paramBVal = 1; paramBVal <= 5; paramBVal++) 


int delegateCallResult = del(paramAVal, paramBVal); 
RABIES BAMA RAE ca FUP Ei SE: 


Write (5"f({paramAVal}, ”十 
o"{paramBVal})={delegateCallResult}"); 

if (paramBVal != 5) 

{ 


Write(", "); 
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—— 


WriteLine(); 
] 
} 
在 Main0 方 法 中 , 创建 了 3 个 Lambda 表达 式 ， 使 用 它们 依次 调用 PerformOperations()。 第 一 个 调用 如 下 
所 示 : 


WriteLine("f(a, b) = a + b:"); 
PerformOperations((paramA, paramB) => paramA + paramB); 


这 里 使 用 的 Lambda 表达 式 如 下 : 
(paramA, paramB) => paramA + paramB 


这 个 Lambda 表达 式 分 为 以 下 3 部 分 : 

(1) 参数 定义 部 分 。 这 里 有 两 个 参数 paramA 和 paramB。 这 些 参 数 都 是 未 类 型 化 的 ， 因 此 编译 器 可 根据 
上 下 文 推断 出 它们 的 类 型 。 在 这 个 例子 中 ， 编 详 器 可 以 确定 ，PerformOperations0 方 法 调用 需要 一 个 
TwolntegerOperationDelegate 类 型 的 委托 。 这 个 委托 类 型 有 两 个 int 参数 ， 所 以 根据 推断 ，paramA 和 paramB 都 是 int 

(2) 一 运算 符 。 它 把 Lambda 表达 式 的 参数 与 表达 式 体 分 开 。 

(3) 表达 式 体 。 它 指定 了 一 个 简单 操作 ， 把 paramA 和 paramB 加 起 来 。 注 意 ， 不 需要 指定 这 是 返回 值 。 编 
译 嚣 知道， 要 创建 可 以 使 用 TwolntegerOperationDelegate 的 方法 ， 这 个 方法 就 必须 有 int 返回 类 型 。 根 据 指 定 的 
操作 ，paramA + paramB 等 于 一 个 int 类 型 的 值 ， 且 没有 提供 额外 的 信息 ， 所 以 编译 器 推 岂 ， 这 个 表达 式 的 结果 
束 是 方法 的 返回 类 型 。 

BOB. min] JOE Hx Lambda 表达 式 的 代 人 码 扩展 到 下 面 使 用 匿名 方法 的 代码 中 : 

WriteLine("f(a, b) = a + b:"); 
PerformOperations (delegate(int paramA, int paramB) 


{ 
return paramA + paramB; 
he 


其 余 代码 以 相同 方式 使 用 两 个 不 同 的 Lambda 表达 式 来 执行 操作 : 

WriteLine(); 

WriteLine("f(a, b) =a * b:"); 

PerformOperations((paramA, paramB) => paramA * paramB); 

WriteLine(); 

WriteLine("fí(a, b) = (a- b) $ b:"); 

PerformOperations((paramA, paramB) => (paramA - paramB) 
$ paramB); 

ReadKey () ; 


最 后 一 个 Lambda 表达 式 涉及 较 多 计算 ， 但 并 不 比 其 他 Lambda 表达 式 更 复杂 。Lambda 表达 式 的 语法 允许 
执行 更 复杂 的 操作 ， 如 稍 后 所 述 。 


13.11.3 Lambda 表达 式 的 参数 

在 前 面 的 代码 中 ，Lambda 表达 式 使 用 类 型 推理 功能 来 确定 所 传递 的 参数 类 型 。 实 际 上 这 不 是 必需 的 ， 也 
可 以 定义 类 型 。 例 如 ， 可 使 用 下 面 的 Lambda KAR: 

(int paramA, int paramB) => paramA + paramB 

其 优点 是 代码 更 便于 理解 ,缺点 是 不 够 简明 灵活 。 在 前 面 委托 类 型 的 示例 中 ,可 以 通过 隐 式 类 型 化 的 Lambda 
表达 式 来 使 用 其 他 数字 类 型 ， 例 如 ，long 变量 。 

注意 ， 不 能 在 同一 个 Lambda 表达 式 中 同时 使 用 隐 式 和 显 式 的 参数 类 型 。 下 面 的 Lambda 表达 式 束 不 会 编 
详 ， 因 为 paramA 是 显 式 类 型 化 的 ， 而 paramB 是 隐 式 类 型 化 的 : 


(int paramA, paramB) => paramA + paramB 
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Lambda 表达 式 的 参数 列表 始终 包含 一 个 用 逗号 分 隔 的 列表 ， 其 中 的 参数 要 么 都 是 显 式 类 型 化 的 ， 要 么 都 
是 隐 式 类 型 化 的 。 如 果 只 有 一 个 隐 式 类 型 化 的 参数 ， 束 可 以 省 略 括号 ; 否则 就 需要 在 参数 列表 上 加 上 括号 ， 如 
前 面 所 示 。 例 如 ， 下 面 的 Lambda 表达 式 只 有 一 个 参数 ， 且 是 隐 式 类 型 化 的 : 

paraml => paraml * paraml 

还 可 以 定义 没有 参数 的 Lambda 表达 式 ， 这 使 用 空 括号 来 表示 : 


() => Math.PI 


当 委托 不 需要 参数 ， 但 需要 返回 一 个 double 值 时 ， 就 可 以 使 用 这 个 Lambda 表达 式 。 
13.11.4 Lambda 表达 式 的 语句 体 


在 前 面 的 所 有 代码 中 ，Lambda 表达 式 的 语句 体 都 只 使 用 了 一 个 表达 式 。 我 们 还 说 明了 这 个 表达 式 如 何 解 
FEA Lambda 表达 式 的 返回 值 ， 例 如 ， 如 何 给 返回 类 型 为 int 的 委托 使 用 表达 式 paramA+ paramB 作为 Lambda 
表达 式 的 语句 体 (假定 paramA 和 paramB 隐 式 或 显 式 类 型 化 为 nt 值 ， 如 示例 代码 所 示 )。 

前 一 个 示例 说 明了 对 于 语句 体 中 使 用 的 代码 而 言 ， 返 回 类 型 为 void 的 委托 的 要 求 并 不 局 : 


myTimer.Elapsed += (source, e) => WriteLine("Event handler called after " + 
S"{ (source as Timer).Interval] milliseconds."); 


上 和 面 的 语句 不 返回 任何 值 ， 所 以 它 只 是 执行 ， 其 返回 值 不 在 任何 地 方 使 用 。 

可 将 Lambda 表达 式 看 成 匿名 方法 语法 的 扩展 ， 所 以 还 可 以 在 Lambda 表达 式 的 语句 体 中 包含 多 个 语句 。 
为 此 ， 只 需要 把 代码 块 放 在 花 括 号 中 ， 类 似 于 C# 中 提供 多 行 代码 的 其 他 情况 : 

(paraml, param2) => 


// Multiple statements ahoy! 
} 


如 果 使 用 Lambda 表达 式 和 返回 类 型 不 是 void 的 委托 类 型 ， 就 必须 用 return 关键 字 返 回 一 个 值 ， 这 与 其 他 
方法 一 样 : 
(paraml, param2) => 
{ 
// Multiple statements ahoy! 
return returnValue; 
} 
例如 ， 可 将 前 面 示 例 中 的 如 下 代码 : 
PerformOperations((paramA, paramB) => paramA + paramB); 
改写 为 : 
Performoperations (delegate(int paramA, int paramB) 


return paramA + paramB; 
ag 


另外 ， 也 可 以 把 代码 改写 为 : 
PerformOperations((paramA, paramB) => 


return paramA + paramB; 
i 


这 更 像 是 原来 的 代码 ， 因 为 它 保持 了 paramA 和 paramB 参数 的 隐 式 类 型 化 。 
大 多 数 情 况 下 ， 在 使 用 单一 表达 式 时 ，Lambda 表达 式 最 有 用 ， 也 最 人 简洁。 坦率 地 讲 ， 如 果 和 需要 多 个 语句 ， 
则 定义 一 个 单独 的 非 匿名 方法 来 蔡 代 Lambda 表达 式 比较 好 ， 这 也 会 使 代码 更 便于 重用 。 


13.11.5 Lambda 表达 式 用 作 委 托 和 表达 式 树 
前 面 提 到 了 Lambda 表达 式 和 匿名 方法 的 一 些 区 别 : Lambda 表达 式 比较 灵活 ， 例 如 ， 隐 式 类 型 化 的 参数 。 
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现在 ， 应 注意 另 一 个 重要 区 别 ， 但 在 学 习 本 书后 面 的 LINQ 之 前 ， 这 个 区 别 的 意义 并 不 是 很 明显 。 

可 采用 两 种 方式 来 解释 Lambda 表达 式 。 

第 一 ， 如 本 章 所 述 ，Lambda 表达 式 是 一 个 委托 。 即 可 以 把 Lambda 表达 式 赋 予 一 个 委托 类 型 的 变量 ， 如 前 
面 的 示例 所 示 。 

一 般 可 以 把 拥有 人 至 多 8 个 参数 的 Lambda 表达 式 表 示 为 如 下 泛 型 类 型 ,它们 都 在 System 名 称 名 空间 中 定义 : 

€ Action， 表 示 的 Lambda 表达 式 不 融 参 数 ， 人 返回 类 型 是 void 

e Action-—, XR] Lambda 表达 式 有 至 多 8 个 参数 ， 返 回 类 型 是 void 

e Func<>， 表 示 的 Lambda 表达 式 有 人 至 多 8 个 参数 ， 返 回 类 型 不 是 void 

Action<> € fi 8 个 泛 型 类 型 的 参数 ， 分 别 用 于 Lambda KAAN 8 个 参数 ，Func<> 最 多 有 9 iz ASA 
的 参数 ， 分 别 用 于 Lambda 表达 式 的 8 个 参数 和 返回 类 型 。 在 Func<> 中 ， 返 回 类 型 始终 在 列表 的 最 后 。 

例如 ， 下 面 的 Lambda 表达 式 : 


(int paramA, int paramB) => paramA + paramB 


可 以 表示 为 Func<int int, inf> 类 型 的 委托 ， 因 为 它 有 两 个 int 参数 ， 返 回 类 型 是 mt。 注意 ， 在 很 多 情况 下 ， 
可 以 使 用 这 些 泛 型 委托 类 型 ， 而 不 必定 义 目 己 的 泛 型 委托 类 型 。 例 如 ， 可 以 使 用 它们 代 蔡 前 面 的 示例 中 定义 的 
TwolntegerOperationDelegate 委托 。 

第 二 ， 可 以 把 Lambda 表达 式 解 释 为 表达 式 树 。 表 达 式 树 是 Lambda 表达 式 的 抽象 表示 ， 因 此 不 能 直接 
执行 。 可 使 用 表达 式 树 以 编程 方式 来 分 析 Lambda 表达 式 ， 执 行 操作 ， 以 响应 Lambda 表达 式 。 

显然 这 是 一 个 复杂 主题 , 但 表达 式 树 对 本 书后 面 介 绍 的 LINQ 功能 至 天 重要 。 下 面 列 举 一 个 具体 例子 .LINQ 
框架 包含 一 个 泛 型 类 Expression< >， 可 用 于 封装 Lambda 表达 式 。 使 用 这 个 类 的 一 种 方式 是 提取 用 C# 编 写 的 
Lambda 表达 式 ， 把 它 转换 为 相应 的 SQL 脚本 ， 以 便 在 数据 库 中 直接 执行 。 

目前 并 不 需要 了 解 太 多 内 容 ， 在 本 书后 面 遇 到 这 个 功能 时 ， 能 更 好 地 理解 其 过 程 ， 因 为 现在 我 们 已 经 理解 
了 C# 语 言 提 供 的 一 些 重要 概念 。 


13.11.6 Lambda 表达 式 和 集合 


学 习 了 Fune< > 泛 型 委托 后 ， 就 可 以 理解 System.Linq 名 称 空间 为 数组 类 型 提供 的 一 些 扩展 方法 了 (在 编码 
的 不 同 地 方 ， 可 在 弹出 IntelliSense 时 看 到 它们 )。 例 如 ， 有 一 个 扩展 方法 Aggregate0 定 义 了 3 TERRE, d 
下 所 示 : 


public static TSource Aggregate<TSource> ( 
this IEnumerable«cTSource» source, 
Func«TSource, TSource, TSource> func); 

public static TAccumulate Aggregate<TSource, TAccumulate-( 
this IEnumerable<TSource> source, 
TAccumulate seed, 
Func«TAccumulate, TSource, TAccumulate> func); 

public static TResult Aggregate<TSource, TAccumulate, 

Aggregate<TSource, TAccumulate, TResult>( TResult> ( 

this IEnumerable«cTSource» source, 
TAccumulate seed, 
Func«TAccumulate, TSource, TAccumulate> func, 
Func«TAccumulate, TResult» resultSelector); 


与 前 面 的 扩展 方法 一 样 ， 这 段 代 码 初 看 上 去 非 芝 深奥， 但 如 条 分 解 它 们 ， 融 很 容易 理解 其 工作 过 程 。 这 个 
函数 的 IntelliSense 告诉 用 户 它 会 执行 如 下 工作 : 

Applies an accumulator function over a sequence. 

Jo BEF A Ml as PABA VASA Lambda #eiA XXE site hE) MA Se PM FP a BAG RE RET 763 
E. AP AMM ADA ATS SOME. HPSS SUE SHCA, A-TSSRE-PH HEA, E 
合 中 的 第 一 个 值 ， 或 者 前 一 次 计算 的 结果 。 

在 3 个 重 载 版 本 中 ， 最 简单 的 版 本 只 有 一 个 泛 型 类 型 ， 这 可 从 实例 参数 的 类 型 推理 出 来 。 例 如 ， 在 下 面 的 
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代码 中 ， 泛 型 类 型 是 int( 累 加 器 图 数 现在 是 空 的 ): 


int[] myIntArray = (2, 6, 3 }? 
int result = myIntArray.Aggregate(...); 


这 等 价 于 : 


int[] myIntArray = { 2, 6, 3 ): 
int result = myIntArray.Aggregate«int»(...); 


这 里 需要 的 Lambda KAEA AMS ETE EIT KK. FER ECG, 284! TSource 是 int， 所 以 必须 为 
委托 Func<int, int, in 人 提供 一 个 Lambda 表达 式 。 例 如 ， 可 以 使 用 前 和 面 的 Lambda 表达 式 : 


int[] myIntArray = (2, 6, 3 }? 
int result = myIntArray.Aggregate((paramA, paramB) => paramA + paramB) ; 


这 个 调用 会 使 Lambda KANHA, OMENS UE paramA=2, paramB-6. 71 —-UKRANS be 
paramA=8( 第 一 次 计算 的 结果 )，paramB=3。 最 后 赋予 变量 result 的 结果 是 int 值 11， 即 数组 中 所 有 元 条 的 总 和 。 
扩展 方法 Aggregate0 的 其 他 两 个 重 载 版 本 是 类 似 的 , 但 可 以 执行 略微 复杂 的 计算 , 如 下 面 的 简短 示例 所 示 。 


试 一 试 ” 使 用 Lambda 表达 式 和 集合 : Ch13Ex09\Program.cs 


(1) 在 Ci\BeginningCSharp7\Chapter13 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Ch13Ex09。 
(2) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


static void Main(string[] args) 
{ 
string[] people = { "Donna", "Mary", "Andrea" }; 
WriteLine (people.Aggregate( 
(a, b) => a+" "+ b)); 
WriteLine (people .Aggregate<string, int>/( 
0, 
(a, b) => a + b.Length)); 
WriteLine (people .Aggregate<string, string, string>( 
"Some people:", 
(a, b) => a+" "+b5, 
a => a)); 
WriteLine (people .Aggregate<string, string, int>( 
"Some people:", 
(a, b) = art" "+b, 
a => a.Length)); 


ReadKey () ; 
} 
(3) 运行 应 用 程序 ， 结 果 如 图 13-21 所 示 。 
" 
图 13-1 
示例 说 明 


这 个 示例 把 包含 3 个 元 系 的 字符 串 数 组 作为 源 数 据 ， 试 验 了 扩展 方法 Aggregate0 的 每 个 重 载 版 本 。 
自 先 执行 一 个 简单 的 串联 操作 : 


WriteLine(people.Aggregate((a, b) => a+" "+ b)): 


5B — eo 3 A fad SY Vr BRE. ORE, SRA 3 77638 89045 Inl 
Lambda 表达 式 ， 其 方式 与 前 面 要 计算 总 和 的 int 值 相同 。 结 果 是 串联 整个 数组 ， 并 用 空格 分 隔 各 个 项 。 使 用 
string.Join0 方 法 能 够 更 方便 地 实现 同样 的 效果 ， 但 本 示例 中 演示 的 其 他 重 载 版 本 提供 了 string.JoinQ ^ B. £& I1] 291 
外 功能 。 

接着 使 用 Aggregate0) 函 数 的 第 二 个 午 载 版 本 ， 它 有 两 个 演 型 类 型 的 参数 TSource 和 TAccumulate。 在 这 个 示 
例 中 ，Lambda 表达 式 的 形式 必须 是 Func<TAccumulate TSource，TAccumulate=>。 另 外 ， 必 须 指 定 TAccumulate 
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类 型 的 种 子 值 ， 这 个 种 子 值 和 第 一 个 数组 元 素 在 Lambda 表达 式 的 第 一 次 调用 中 使 用 。 后 续 调 用 从 前 面 的 调用 
中 把 累加 器 的 结 昌 提取 到 表达 式 中 。 代 码 如 下 : 
WriteLine (people.Agqgregate<string, int»( 


0, 
(a, b) => a + b.Length)); 


累加 器 (以 及 返回 值 ) 的 类 型 是 int. AUI RETI E EE] eA 1-48. 0, 在 对 Lambda 表达 式 的 每 次 调用 中 ， 都 
把 该 值 累加 到 数组 元 素 的 长 度 上 。 最 后 的 结果 是 数组 中 所 有 元 素 的 总 长 度 。 
之 后 使 用 Agsregate0 函 数 的 最 后 一 个 重 载 版 本 ， 它 带 有 3 个 泛 型 类 型 的 参数 ， 与 前 一 个 重 载 版 本 的 唯一 区 别 
是 ， 其 返回 类 型 可 不 同 于 数组 元 素 和 昧 加 值 的 类 型 。 首 先 ， 这 个 重 载 版 本 把 字符 串 元 系 与 种 子 字符 串联 在 一 起 ; 
SEE e Hess string, string> ( 


(a, b) => at™ "+5, 
a => a)); 


即使 累加 值 只 是 复制 到 结果 中 (如 本 例 所 示 )， 也 必须 指定 这 个 方法 的 最 后 一 个 参数 resultSelector。 这 个 参数 
是 一 个 Fune<TAccumulate, TResult > 类 型 的 Lambda 表达 式 。 
在 最 后 一 段 代码 中 ,再 次 使 用 了 了 Aggregate0 的 这 个 版 本 ,但 这 次 使 用 int 类 型 的 返回 值 。 其 中 ,给 resultSelector 
提供 一 个 Lambda 表达 式 ， 返 回 累加 字符 串 的 长 度 : 
WriteLine (people.Aggregate<string, string, int>( 
"Some people:", 


(a, b) => A + m n 4 b, 
a => a.Length)); 


IX TANIA IT HERB INST, (BAN SEA SE RETI] Jg is HP ATA. TI 
看 似 复杂 的 语法 。 本 书后 和 面 还 将 予以 讨论 。 


13.12 “习题 


(1) 编写 事件 处 理 程 序 的 代码 ， 这 些 代 码 使 用 了 通用 语法 (object sender, EventArgs e)， 该 语法 将 接受 本 章 前 
面 的 TimerElapsed 或 Connection.MessageArrived 事件 .处 理 程序 应 输出 一 个 表示 接收 了 什么 类 型 事件 的 字符 串 ， 
并 根据 引发 的 事件 ， 输 出 MessageArrivedEventArgs 参数 的 Message 属性 或 ElapsedEventArgs 参数 的 SignalTime 
属性 。 

(2) 修改 扑 死 牌 洲 戏 示例 ， 设 置 流行 拉 米 扑 死 牌 的 更 有 趣 的 取胜 条 件 。 即 一 个 玩家 要 取胜 ， 手 中 的 牌 必 须 
包含 两 套 牌 ， 一 套 由 3 张 牌 组 成 ， 男 一 套 由 4 张 牌 组 成 。 一 套 牌 应 是 连续 的 同 花 色 的 牌 (例如 ，3H、4H、5H、 
6 印 或 者 几 张 同 点 的 牌 ( 例 如 ，2H、2D、25S)。 

(3) ATTA BEE S 97A as PAE? 修改 这 个 类 ， 使 其 能 使 用 对 象 初始 化 右 。 之 后 列举 一 个 代 
码 示例 ， 仅 通过 一 个 步骤 实例 化 和 初始 化 这 个 类 : 

public class Giraffe 

ere Giraffe (double neckLength, string name) 

i NeckLength = neckLength; 
uM = ee 


} 
public double NeckLength {get; set;} 
public string Name {get; set;} 

} 


(4) 判断 正 误 : 如 果 声 明 一 个 var 类 型 的 变量 ， 就 可 以 使 用 它 存储 任意 对 象 类 型 。 
(5) 使 用 匿名 类 型 时 ， 如 何 比较 两 个 实例 ， 确 定 它 们 是 任 包 含 相同 的 数据 ? 

(6) 更 正 下 和 面 扩展 方法 的 代码 ， 其 中 包含 一 个 错误 : 

public string ToAcronym(this string inputstring) 


inputString = inputString.Trim(); 
if (inputString == "") 


{ 
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return "":; 


} 


string[] inputStringAsArray = inputString.Split(' '); 
StringBuilder sb = new StringBuilder (); 
for (int i = 0; i < inputStringAsArray.Length; i++) 


{ 


if (inputStringAsArray[il.Length > 0) 


{ 
sb.AppendFormat ("[0]", 


} 


} 


inputStringAsArray [i] .Substring ( 
0, 1).ToUpper()); 


return sb.ToString(); 


} 


(7) 如 何 确 保 习题 (90) 中 的 扩展 方法 可 用 于 客户 代码 ? 


(8) 把 ToAcronym 方法 改 为 一 条 语句 。 该 代码 应 确保 单词 之 间 包 含 多 个 空格 的 字符 串 不 会 出 错 。 提 示 : i 


= 
mi 


要 使 用 ?: 二 元 运算 付 、string.Agegregate<string, strine>0 扩 展 方法 和 一 个 Lambda 表达 式 。 
附录 A 给 出 了 习题 答案 。 


13.13 ”本章 要 点 


E m 
名 称 空间 
限定 
定制 异 第 


事件 处 理 


事件 定义 


匿名 方法 


初始 化 器 


类 型 推理 


匿名 类 型 


要 A 
为 避免 名 称 空间 限定 的 模糊 性 ， 可 以 使 用 :: 运 算 符 强 制 编译 融 使 用 已 创建 好 的 别名 。 还 可 以 使 用 global 名 称 空 间作 
为 顶级 名 称 空间 的 别名 
从 根 类 Exception 中 派生 ， 就 可 以 创建 自己 的 异常 类 。 这 是 有 益 的 ， 因 为 可 以 更 多 地 控制 特定 异常 的 捕获 ， 并 人 允许 
定制 包含 在 异常 中 的 数据 ， 以 高 效 地 处 理 它 
许多 关 都 提供 了 事件 ， 在 代码 中 发 生 茶 个 触发 器 时 ， 束 会 引发 这 些 事件 。 可 为 这 些 事件 编写 处 理 程序 ， 在 引发 事 
件 时 执行 代码 。 这 种 双 同 通信 方式 是 啊 应 代码 的 一 种 展 好 机 制 ， 不 必 编 写 可 能 要 轮 询 对 象 以 获知 变化 的 复杂 、 令 
人 感到 费解 的 代码 
可 以 定义 目 己 的 事件 类 型 ， 这 涉及 给 事件 的 处 理 程序 创建 指定 的 事件 和 委托 类 型 。 可 以 使 用 标准 的 、 无 返回 类 型 
的 委托 类 型 和 派生 于 System.EventArgs 的 定制 事件 参数 ， 使 事件 处 理 程序 有 多 种 用 途 。 还 可 以 使 用 EventHandler 
和 EventHandler<T> 委 托 类 型 ， 以 便 通 过 更 简单 的 代码 来 定义 事件 
为 使 代码 更 便于 阅读 ， 第 可 以 使 用 匿名 方法 来 普 代 完整 的 事件 处 理 方法 。 这 表示 ， 在 添加 事件 处 理 程序 的 地 方 直 
接 定义 要 在 引发 事件 时 执行 的 代码 ， 为 此 需要 使 用 delegate KEF 
Aij, 或 者 是 由 于 所 用 框 染 的 要 求 , 或 者 是 由 于 目 己 的 需要 , 在 代码 中 会 用 到 特性 。 通 过 使 用 [AttributeName] 语 法 ， 
可 以 向 类 、 方 法 和 其 他 成 员 添 加 特性 ， 通 过 从 System.Attribute 派生 ， 可 以 创建 自己 的 特性 。 通 过 反射 可 读 取 特性 值 
可 使 用 初始 化 器 在 创建 对 象 或 集合 的 同时 初始 化 它们 。 这 两 种 初始 化 器 都 包括 一 个 放 在 花 括号 中 的 代码 块 。 对 象 
初始 化 右 可 以 提供 一 个 加 写 分 阳 的 属性 名 / 值 对 列表 ， 来 设置 属性 值 。 集 合 初 始 化 右 仅 需要 逗 写 分 阳 的 值 列表 。 使 
用 对 象 初始 化 器 时 ， 还 可 以 使 用 非 默 认 的 构造 函数 
声明 变量 时 ， 使 用 var 关键 字 允 许 忽 略 变 量 的 类 型 。 但 只 有 类 型 可 以 在 编译 期 间 确定 时 才 可 以 这 人 么 做 。 使 用 var 没 
有 违反 C# 的 强 类 型 化 规则 ， 因 为 用 var 声明 的 变量 只 能 有 一 种 类 型 
对 于 用 于 数据 存储 的 许多 简单 类 型 ， 并 非 必须 定义 类 型 。 相 反 ， 可 以 使 用 匿名 类 型 ， 其 成 员 根据 用 途 来 推断 。 使 
用 对 象 初始 化 吉 语 法 来 定义 匿名 类 型 ， 每 个 设置 的 属性 都 定义 为 只 读 属 性 
使 用 dynamic 关键 字 定 义 dynamic 类 型 的 变量 ， 可 以 存储 任意 值 。 接 着 就 可 以 使 用 一 般 的 属性 或 方法 语法 来 访问 
该 变量 中 包含 的 值 的 成 员 ， 这 些 成 员 仅 在 运行 期 间 检 查 。 如 果 在 运行 期 间 ， 尝 试 访 问 一 个 不 存在 的 成 员 ， 就 会 抛 
出 一 个 异常 。 这 种 动态 的 类 型 化 显著 简化 了 访问 非 .NET 类 型 或 类 型 信息 不 能 在 编译 期 间 获 得 的 .NET 类 型 的 语法 。 
但 是 ， 在 使 用 动态 类 型 时 要 谨慎 ， 因 为 无 法 在 编译 期 间 检查 代码 。 实 现 IDynamicMetaObjectProvider 接口 ， 可 以 控 
制 动 态 查 找 的 行为 
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t om 
可 选 的 方 
命名 的 方 


Lambda 
表达 式 


( 续 表 ) 

要 A 
我 们 常常 可 以 定义 带 许多 参数 的 方法 ， 但 其 中 的 许多 参数 都 很 少 使 用 。 可 以 提供 多 个 方法 重 载 ， 而 不 是 强制 客户 
代码 为 很 少 使 用 的 参数 提供 值 。 男 外 ， 也 可 以 把 这 些 参数 定义 为 可 选 参数 (并 为 未 指定 值 的 参数 据 供 默认 值 )。 调 用 
方法 的 客户 代码 就 可 以 仅 指 定 需 要 的 参数 
客户 代码 可 以 根据 位 置 或 名 称 (或 者 根据 位 置 和 名 称 ， 其 中 位 置 参数 放 在 前 面 ) 来 指定 方法 的 参数 。 命名 的 参数 可 按 
任意 顺序 指定 。 这 尤其 适用 于 和 可 选 参数 一 起 使 用 的 场合 
Lambda 表达 式 实际 上 是 定义 匿名 方法 的 一 种 快捷 方式 , 而 且 具 有 和 铬 外 的 功能 ， 例如 隐 式 的 类 型 化 。 定义 Lambda 
表达 式 时 ， 需 要 使 用 逗号 分 隔 的 参数 列表 (如 果 没 有 参数 ， 束 使 用 空 插 号 )、 一 运算 符 和 一 个 表达 式 。 该 表达 式 可 
以 是 放 在 花 括 号 中 的 代码 块 。Lambda 表达 式 至 多 可 以 有 8 个 参数 和 一 个 可 选 的 返回 类 型 ，Lambda 表达 式 可 以 用 
Action、Action<> 和 Func< 委托 类 型 来 表示 。 许 多 可 用 于 集 侣 的 LINQ 扩展 方法 都 使 用 Lambda 表达 式 参 数 
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PTER 


S R E tE 


REAR: 

e ”如何 使 用 WPF 设计 器 

e 如 何 使 用 Label 和 TextBlock 等 控件 向 用 户 呈现 信息 

e 如 何 使 用 Button 等 控件 触发 事件 

e 如何 使 用 TextBox 等 控件 让 应 用 程序 的 用 户 输入 文本 

e 如 何 使 用 RadioButton 和 CheckBox 等 控件 将 应 用 程序 的 当前 状态 告知 用 户 ， 并 人 允许 用 户 修改 状态 
e 如 何 使 用 ListBox 和 ComboBox 等 控件 显示 信息 列表 

e 如 何 使 用 窗 格 对 用 户 界面 进行 布局 


本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapterl4 文件 夹 中 并 已 根据 本 章 示 例 的 
名 称 单独 命名 。 


本 书 第 I 部 分 由 内 而 外 详细 介绍 了 C# 语 言 的 一 些 知 识 ， 但 从 本 章 开 始 ， 不 再 介绍 编程 语言 的 细节 ， 而 将 
进入 图 形 用 户 界 和 面 (Graphical User Interface，GUD 的 世界 。 

过 去 许多 年 中 ，Visual Studio 为 Windows 开发 人 员 提 供 了 多 种 创建 用 户 界 面 的 方法 : Windows Forms 是 用 
于 创建 传统 Windows 应 用 程序 的 基本 工具 ，Windows Presentation Foundation (WPF) 则 提供 更 广泛 的 应 用 程序 类 
型 ， 并 尝试 解决 Windows Forms 中 存在 的 很 多 问题 。 从 技术 角度 看 ，WPF 是 独立 于 平台 的 ， 我 们 能 够 以 多 种 
有 趣 的 方式 使 用 它 , 第 25 章 将 介绍 如 何 用 WPF 创建 针对 于 其 他 Windows 平台 (如 Surface tablet 或 Xbox) 的 应 用 
程序 。 本 章 和 下 一 章 将 讨论 如 何 用 WPF 创建 典型 的 Windows 应 用 程序 。 

对 于 大 多 数 图 形 Windows 应 用 程序 而 言 ， 开 发 核心 是 窗口 设计 器 。 为 创建 用 户 界 面 ， 将 控件 从 工具 箱 拖 放 
到 窗口 中 ， 放 在 应 用 程序 运行 时 希望 其 出 现 的 位 置 上 。 而 在 WPF 中 ， 则 不 完全 是 这 样 ， 原 因 是 用 户 界面 实际 
上 完全 由 另 一 种 称 为 “可 扩展 应 用 程序 标记 语言 (Extensible Application Markup Language， 集 称 XAML， 访 作 
zammel) 的 语言 来 编写 。 在 Visual Studio 中 ， 两 种 方式 都 可 行 ， 随 大 上 日 己 更 加 熟悉 WPF， 既 可 以 拖 暇 控件 ， 也 
可 以 直接 编写 XAML 代码 。 

本 章 将 使 用 Visual Studio WPF 设计 器 为 前 面 章节 中 编写 的 纸牌 游戏 创建 很 多 窗口 。Visual Studio 中 目 市 了 许 
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多 拥有 广泛 功能 的 控件 ， 本 章 将 用 到 其 中 的 一 部 分 。 利 用 Visual Studio 的 设计 功能 ， 开 友 用 户 界 面 和 处 理 用 户 
区 互 变 得 十 分 直观 ， 而 且 充 满 趣味 ! 由 于 篇 幅 所 限 ， 本 书 无 法 涵 兽 所 有 Visual Studio 控件 。 本 章 要 介绍 一 些 最 
营 用 的 控件 ， 包 括 标签 、 文 本 框 、 采 单 栏 和 布局 面板 等 控件 。 


14.1 XAML 


XAML 是 一 门 使 用 XML 语法 的 语言 ， 人 允许 以 层次 化 的 声明 方式 将 控件 添加 到 用 户 界 面 中 。 也 就 是 说 ， 可 
以 采用 XML 元 系 的 形式 添加 控件 ， 并 使 用 XML 特性 来 指定 控件 属性 。 也 可 以 使 用 包含 其 他 控件 的 控件 ， 这 在 
布局 和 功能 上 都 是 必需 让 


第 21 章 将 详细 介绍 XML。 如 果 此 时 希望 快速 了 解 XML 的 基础 知识 ， 可 直接 跳 到 该 章 ， 阅 读 其 前 几 页 的 
内 容 。 


XAML 在 设计 时 就 考虑 到 利用 当今 功能 强大 的 显卡 ， 人 允许 通 过 DirectX 来 使 用 这 些 显 卡 提 供 的 所 有 噩 级 功 
能 。 下 面 列 出 其 中 一 些 功能 : 
e 浮 点 坐标 和 天 量 图 形 ， 人 允许 在 不 损失 质量 的 情况 下 缩放 、 旋 转 和 转换 布局 
局 级 2D 和 3D 得 染 功能 
yA ER A Ys OS 
UI 对 象 文 持 纯色 、 渐 变 和 纹理 填 亢 ， 并 可 选择 透明 度 
可 在 任何 情形 中 使 用 的 动画 分 镜头 设计 ， 包 括 鼠 标 单 击 按钮 等 用 户 触 上 帮 的 事件 
可 使 用 可 重用 的 资源 来 动态 设置 控件 的 样式 


14.1.1 关注 点 分 离 


在 过 去 许多 年 中 ,维护 Windows 应 用 程序 的 一 个 问题 在 于 ， 生 成 用 户 界面 的 代码 和 基于 用 户 操作 执行 的 代 
码 经 疝 混 合 在 一 起 。 这 导致 多 个 开 上 有 人员 和 设计 人 员 难 以 处 理 同 一 个 项 目 。WPF 通过 两 种 途径 解决 这 个 问题 。 
首先 ， 使 用 XAML( 而 不 是 CHRR GUI, GUI 因此 变 得 独立 于 平台 ， 实 际 上 ， 可 在 不 使 用 任何 代码 的 情况 下 
渔 染 XAML。 其 次 ， 很 目 然 会 将 C# 代 码 与 GUI 代码 放 在 不 同文 件 中 。Visual Studio 使 用 了 “代码 隐藏 文件 ” 
即 能 动态 链接 到 XAML 文件 的 C# 文 件 。 

由 于 GUI 与 代码 分 离开 来 , 可 以 创建 定制 的 应 用 程序 来 设计 GUI, Microsoft 已 经 做 到 了 这 一 点 。Blend for 
Visual Studio 是 设计 师 们 为 WPF 制作 GUI 时 的 首选 工具 。 该 工具 可 与 Visual Studio 加 载 相同 的 项 目 ， 但 Visual 
Studio 主要 面 问 开发 人 员 ， 而 不 是 设计 人 员 : Blend 恰好 相反 。 也 就 是 说 ， 如 果 有 许多 设计 人 员 和 开发 人 员 参 
与 到 大 型 项 目 中 ， 他 们 可 以 使 用 各 自 喜 欢 的 工具 共同 处 理 同 一 个 项 目 ， 而 不 必 担 心 无 意 间 影响 他 人 的 工作 。 


14.1.2 XAML 基础 知识 


正如 前 面 介 绍 的 那样 ，XAML 是 XML 语言 ， 这 意味 着 在 XAML 较 小 时 , 我们 可 以 直接 看 消 代 人 码 所 要 表达 
的 含义 。 请 分 析 下 面 这 段 代码 ， 看 你 能 人 省 理 解 它 所 要 表达 的 含义 : 


«Window x:Class-"Chl4Ex01.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:WpfAppl" 
mc:Ignorable-"d" 

Title-"Hello World" Height-"350" Width="525"> 
«Grid» 
«Button Content-"Hello World" 
HorizontalAlignment-"Left" 
Margin-"220,151,0,0" 
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VerticalAlignment-"Top" 
Width="75"/> 


</Grid> 
</Window 


E38 XAML 示例 的 作用 是 创建 市 有 一 个 按钮 的 窗口 。 窗 口 和 按钮 中 都 会 显示 Hello World XÆ. XML 允许 
在 一 个 标签 中 放置 男 一 个 标 合 ， 只 需要 正确 地 闭合 各 个 标签 即 可 。 在 XAML 中 ,如果 将 一 个 元 素 放 在 男 一 个 元 
系 中 ， 前 者 将 成 为 后 者 内容 的 一 部 分 ， 也 就 是 说 Button 部 分 的 代码 也 可 以 编写 为 : 


<Button HorizontalAlignment="Left" 
Margin="220,151,0,0" 
VerticalAlignment-"Top" 
Width="75"> 
Hello World 


</Button> 
Esk 40054, Button 的 Content 属性 被 删除 了 ,这 样 , 区 本 就 成 为 Button 控件 的 子 节 点 ,在 XAML #, Content 


可 以 是 任意 内 容 , 正如 在 上 述 例 子 中 演示 的 那样 : Button 元 素 是 Grid 元 素 的 内 容 , 而 这 个 Grid 元 素 又 是 Window 
TOR WA e 

绝 大 多 数控 件 (但 不 是 全 部 控件 ) 都 可 以 包含 内 容 ， 并 且 对 内 置 控件 外 观 的 修改 只 有 很 少 的 限制 。 第 15 章 将 
详细 介绍 这 部 分 内 容 。 

1. 名 称 空间 

在 上 个 例子 中 ，Window 元 素 是 XAML 文件 的 根 元 素 。 该 元 素 通 常 包含 一 系列 名 称 空 间 声 明 。 上 默认 情况 下 ， 
Visual Studio 设计 器 中 包含 两 个 值得 注意 的 名 称 空 间 : http://schemas.microsoft.com/winfx/2006/xaml/presentation 和 
http://schemas.microsoft.com/winfx/2006/xaml。 前 者 是 WPF 的 默认 名 称 空 间 ， 其 中 声明 了 许多 在 创建 用 户 界 和 面 时 
可 能 用 到 的 控件 。 后 者 则 用 于 声明 XAML 语言 本 里 。 名 称 空间 并 非 必 须 在 根 标签 中 声明 ,不 过 在 这 里 声明 可 以 
保证 整个 XAML 文件 范围 内 都 可 以 方便 地 访问 到 这 个 名 称 空 间 中 的 内 容 , 因此 通 委 没 必要 将 这 些 声 明 放 到 其 他 


注意 : 

名 称 空间 看 起 来 像 是 URL， 但 这 是 有 欺骗 性 的 。 实 际 上 它们 称 为 Uniform Resource Identifiers (URD。URI 
可 以 是 任意 字符 串 ， 只 要 它 唯一 地 标识 一 个 资源 即 可 。Microsoft 选择 通常 用 于 URL 的 形式 指定 URI， 但 在 这 
里 ， 如 果 将 它们 输入 浏览 器 ， 就 不 会 得 到 什么 结果 。 


在 Visual Studio 中 新 建 了 一 个 窗口 后 ， 总 会 默认 声明 一 个 presentation 名 称 空间 ， 而 XAML 语言 的 名 称 空 
间 则 以 xmins:x 形式 进行 声明 。 正 如 Window. Button 和 Grid 标签 那样 ， 这 样 声明 之 后 可 以 不 必 再 为 添加 到 窗 
口中 的 控件 添加 前 级 ， 但 我 们 指定 的 语言 元 系 必 须 标明 x 前 级 。 

最 后 一 个 十 分 弟 见 的 名 称 空间 是 系统 名 称 空间 : xmlns:sys="clr-namespace:System:assembly=mscorlib"。 该 名 
称 空间 允许 在 XAML 中 直接 使 用 .NET Framework 内 置 的 类 型 。 这 样 做 之 后 ， 在 代码 中 所 写 的 标记 可 以 显 式 声 
明 要 创建 的 元 系 类 型 。 例 如 ， 可 在 标记 中 声明 一 个 数组 ， 并 且 表 明 数 组 中 的 成 员 是 字符 串 : 

<Window.Resources> 
<ResourceDictionary> 
«x:Array Type-"sys:String" x:Key="localArray"> 
<sys:String>"Benjamin Perkins"</sys:String> 
<sys:String>"Jacob Vibe Hammer"</sys:String> 
<sys:String>"Job D. Reid"«/sys:String- 
«/X:Array- 


«/ResourceDictionary- 
</Window. Resources> 


2. 代码 隐藏 文件 


尽管 XAML 是 一 种 强大 的 用 户 界 面 声明 方式 , 但 它 并 不 是 一 门 编程 语言 。 如 果 我 们 想 在 界面 表现 的 基础 上 
增加 一 些 功能 ， 则 需要 使 用 C# 代 码 。 虽 然 可 在 XAML PARRA C# 代 码 ， 但 任何 时 候 都 不 建议 将 代码 和 标记 
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混合 在 一 起 ， 因 而 本 书 也 不 会 这 么 做 。 本 书 将 要 大 量 用 到 的 是 “代码 隐藏 文件 (Code-Behind Files)”. 它们 就 是 
普通 的 C# 文 件 ， 只 不 过 其 名 称 与 XAML 文件 相同 ， 再 加 上 .cs 扩展 名 。 尽 管 也 可 以 将 其 命名 为 其 他 文件 名 ， 但 
最 好 遵循 上 述 命名 约定 。 为 应 用 程序 创建 新 窗口 时 ，Visual Studio 会 自动 创建 代码 隐藏 文件 ， 因 为 它 知道 我 们 
会 为 该 窗口 添加 代码 。 同 时 ，Visual Studio 也 会 在 XAML 文件 的 Window 标签 中 添加 x:Class 属性 : 


«Window x:Class="Ch14Ex01.MainWindow" 


这 条 语句 告诉 编译 器 ， 该 窗口 对 应 的 代码 不 在 一 个 单独 文件 中 ， 而 在 Ch14Ex01.MainWindow 类 中 。 因 为 
我 们 只 能 指定 完全 限定 的 类 名 , 不 能 指定 包含 该 类 的 程序 集 , 因此 不 能 把 代码 隐藏 文件 放 在 定义 该 XAML 文件 
的 项 目 之 外 。Visual Studio 自动 将 代码 隐藏 文件 与 XAML 文件 放 在 同一 个 目录 中 ， 因 此 使 用 Visual Studio 时 ， 
我 们 不 必 担 心 改 生 上 述 情 况 。 


14.2 动手 实践 


现在 ， 你 已 经 对 WPF 的 结构 有 了 足够 的 了 解 ， 可 以 开始 亲手 实践 了 。 我 们 一 起 来 了 解 一 下 编辑 右 。 首 先 
新 建 一 个 WPF 项 目 ， 方 法 是 选择 File | New | Project。 在 New Project 对 话 框 中 ， 导 航 到 Visual C# 下 的 Windows 
Classic Desktop 节点 ， 并 选择 项 目 模板 WPF AppCNET Framework). 图 14-1 显示 的 New Project 对 话 框 中 包含 了 
New Project 
frg [NET Framework 4.6.1  -|Sorby[Defaut | 3° [i=] [Search (ct: 


4 Installed — 
rj WPF App (.NET Framework) Visual C* Type Visual C£ 


4 Visual C$ : Windows Presentation Foundation client 
Windows Universal u.c App (.NET Framework) Visual C$ application 
Windows Classic Desktop 
Web E: Console App (.NET Framework) Visual C$ 
NET Core : 

NET Standard 则 r Class Library (.NET Framework) Visual C= 
Android ; 
Cloud Shared Project Visual C= 
Cross-Platform e 
b i05 - Windows Service (.NET Framework) Visual C* 
Test 
ac 
b tvOS ~ | Empty Project (.NET Framework) Visual C4 
> Other Languages - 
t Other Project Types 5 WPF Browser App (.NET Framework) Visual CF 
ii t 


b Onlin ct 
sg all WPF Custom Control Library (NET Framework) Visual C& 
a 


ac 
LÀ WPF User Control Library (NET Framework) Visual C* 


ct 
ii " Windows Forms Control Library (.MET Framework) Visual C* 
Not finding what you are looking for? 


Open Visual Studio Installer 
Mame: WpfApp1 
Location: c:\users\purelake\source\ repos - | Browse... 


Solution name: WpfAppl Create directory for solution 
| | Add to Source Control 


图 14-1 


为 使 这 个 例子 可 以 在 下 一 个 例子 中 重用 ， 把 项 目 命名 为 Ch14Ex01 - 

HÆ, Visual Studio 界面 中 会 显示 一 个 空白 窗口 ， 四 周 则 是 各 种 不 同 的 面板 。 屏 幕 的 主要 区 域 分 为 两 部 分 。 
上 部 为 设计 视图 ， 用 于 显示 当前 设计 的 窗口 的 所 见 即 所 得 (WYSIWYG) 外 观 ， 下 部 是 XAML 视图 ， 用 于 显示 同 
一 窗口 的 代码 。 

在 设计 视图 的 右 侧 ， 是 前 面 项 目 中 已 经 有 所 接触 的 Solution Explorer， 以 及 Properties 面板 ， 该 面板 显示 了 
当前 在 设计 视图 和 XAML 视图 中 所 选 内 容 的 相关 信息 。 需 要 注意 , Properties 面板 中 显示 的 内 容 和 XAML 视图 、 
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设计 视图 中 的 选择 总 是 同步 的 ， 如 果 在 XAML 视图 中 移动 光标 ， 其 他 两 个 区 域 中 的 选择 的 内 容 也 会 随 之 自动 变化 。 

设计 视图 左 侧 有 几 个 折 著 起 来 的 面板 ， 其 中 之 一 是 工具 箱 。 本 章 将 介绍 如 何 使 用 工具 箱 中 的 各 种 控件 为 纸 
牌 游戏 创建 对 话 框 ， 因 此 请 将 其 展开 ， 人 然后 单 击 其 右上 和 角 的 固定 按钮 将 其 固定 为 展开 状态 。 随 后 在 该 面板 中 展 
FF Common WPF Controls 节点 。 本 章 将 主要 介绍 此 处 的 大 部 分 控件 。 


14.2.1 WPF 控件 


所 谓 控件 ， 是 将 程序 代码 和 GUI 预先 打包 到 一 起 ， 可 供 重 复 利 用 ， 并 创建 出 复杂 的 应 用 程序 。 控 件 可 以 定 
丸和 目 身 默认 的 绘制 形式 及 一 系列 标准 行为 。Label、Button 和 TextBox 等 控件 很 容易 识别 ， 因 为 它们 在 Windows 
应 用 程序 中 已 经 被 使 用 了 约 20 年 。 其 他 控件 ， 如 Canvas 和 StackPanel， 不 显示 任何 内 容 ， 只 是 用 来 帮助 创建 
GUI. 

目 市 控件 的 外 观看 起 来 与 标准 Windows 应 用 程序 中 的 控件 是 一 样 的 , 它们 可 按 当前 的 Windows 主题 设 
置 绘制 日 时。 不 过 ， 所 有 外 观 元 系 痢 可 以 融 度 日 定义 ， 只 需要 单 击 几 次 鼠标 ， 就 可 以 完全 改变 这 些 控 件 的 显示 
方式 。 这 样 的 目 定义 是 通过 设置 控件 的 属性 值 来 实现 的 。WPF 不 仅 可 以 使 用 我 们 之 前 所 了 解 到 的 标准 属性 ， 还 
文 持 一 种 新 的 “依赖 属性 (dependency property)". $ 15 章 将 详细 介绍 这 些 属 性 ， 现 在 只 需要 知道 许多 WPF 属 
性 并 不 只 是 可 以 获取 和 设置 值 ， 例 如， 它们 能 将 日 映 的 更 改 告 知 观察 者 。 

除了 可 以 定义 其 在 屏幕 上 的 外 观 外 ， 控 件 中 也 定义 了 一 些 标准 行为 ， 例 如 单 击 按钮 或 从 列表 中 选择 某 项 。 
通过 “处理 ”控件 定义 的 事件 ， 可 以 改变 当 用 户 对 某 个 控件 执行 相应 操作 时 会 发 生 什么 。 何 时 以 及 如 何 实 现 这 
些 事 件 处 理 程序 ， 了 取决 于 具体 的 应 用 程序 和 上 有 具体 的 控件 ， 但 一 般 来 说 ， 对 于 Button 控件 ， 我 们 都 会 处 理 Click 
事件 ， 对 于 ListBox 控件 ， 则 需要 在 用 户 改 变 所 选项 时 执行 某 种 操作 ， 因 此 通常 会 处 理 SelectionChanged 事件 。 
对 于 Label, TextBlock 等 其 他 控件 来 说 ， 也 许 并 不 需要 实现 任何 事件 。 


警告 : 

尽管 当 我 们 花 一 些 时 间 让 用 户 界面 变 得 比 标准 的 Windows 界面 更 有 趣 时 ， 用户 通 常 都 会 很 乐意 接受 , 但 在 
更 改 标准 的 控件 行为 时 ， 请 务必 三 思 。 例 如 ， 假 如 我 们 和 更改 了 Button 控件 ， 使 其 仅 响 应 用 户 的 右 击 操作 ， 这 会 
使 用 户 在 用 和 鼠标 左 键 单 击 该 按钮 之 后 什么 也 不 会 发 生 ， 导 和 致 他 们 认为 这 个 应 用 程序 出 问题 了 。 实 际 上 ， 如 果 仅 
由 于 好 奇 而 像 这 样 修改 按钮 控件 ， 那 么 使 用 其 他 控件 类 型 会 比 直接 修改 Button 控件 的 默认 行为 要 好 得 多 。 


可 通过 多 种 方式 将 控件 添加 到 窗口 中 ,但 最 常见 的 方法 是 直接 将 它们 从 工具 箱 拖 放 到 设计 视图 或 XAML 
视图 中 。 下 面 通过 一 个 简单 的 示例 来 说 明 这 一 后。 


试 一 试 将 控件 添加 到 窗口 中 


在 学 习 本 章 内 容 的 过 程 中 ， 我 们 可 以 目 由 选择 这 加 控件 的 方式 ， 可 将 其 从 工具 箱 拖 上 息 到 设计 视图 ， 也 可 以 
手动 输入 XAML 代码 。 

(1) 首先 将 Button 控件 从 工具 箱 拖 忠 到 设计 视图 中 。 请 注意 观察 XAML 视图 中 的 代码 如 何 进行 相应 更 新 ， 
以 反映 所 做 的 改变 。 

(2) WE, WRIA Button 控件 ， 但 这 次 将 其 放 到 XAML 视图 中 ， 并 且 放 在 第 一 个 按钮 之 后 ，</Grid> 
标签 之 前 。 


示例 说 明 

在 设计 视图 中 看 到 的 结果 可 能 有 些 令 人 吃惊 一 一 第 二 个 按钮 占 满 了 整个 窗口 。 将 控件 拖 蝶 到 设计 视图 时 ， 
Visual Studio 会 星 试 日 动 设置 属性 并 插入 其 子 元 系 ， 以 便 让 该 控件 可 以 按照 标准 外 观 显 示 。 而 将 同样 的 控件 拖 
52531 XAML 视图 时 ， 则 不 会 及 生 这 样 的 调整 ， 插 入 的 只 是 用 来 定义 该 控件 的 那个 标签 而 已。 

可 多 次 疼 试 将 控件 放 在 窗口 中 布 望 的 特定 位 置 ， 但 会 及 现 要 将 位 置 放 得 很 准确 比较 困难 。 此 时 ， 可 直接 将 
其 拖 蝶 到 XAML 视图 中 ， 或 者 手动 输入 相应 的 代码 。 
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如 果 和 希望 拖 间 控件， 但 发 现 很 难 将 其 放 到 正确 位 置 ， 则 可 以 随意 将 其 放置 在 某 个 位 置 ， 然 后 将 为 其 自动 生 
成 的 相应 XAML 代码 剪 切 并 粘贴 到 正确 位 置 即 可 。 


1422 属性 


如 前 文 所 述 ， 所 有 控件 中 都 包含 许多 属性 ， 这 些 属性 可 用 来 控制 控件 的 行为 。 某 些 属性 的 含义 很 容易 理解 ， 
例如 Height 和 Width， 但 某 些 却 难以 理解 ， 例 如 RenderTransform。 所 有 属性 都 可 以 通过 Properties 面板 来 设 
置 ， 也 可 以 直接 在 XAML 中 设置 或 直接 在 设计 视图 中 进行 调整 。 下 面 的 示例 显示 了 如 何在 设计 视图 中 设置 控 
件 属性 。 


注意 : 

创建 一 个 新 项 目 时 ，VWisual Studio 会 给 类 创建 一 个 默认 名 称 空 间 。 随 后 在 项 目 中 添加 新 的 类 或 窗口 时 ， 就 
使 用 该 名 称 空 间 。 在 Solution Explorer 中 双击 Properties， 可 以 更 改 该 名 称 空 间 。 如 果 发 现 类 的 名 称 空间 不 同 于 
示例 中 给 出 的 名 称 空 间 ， 可 以 把 默认 名 称 空间 改 为 本 书 中 的 名 称 空间 。 这 种 改变 只 会 影响 新 类 ， 不 影响 已 在 项 
站 


i—i ”设置 属 性 : Ch14Ex01\MainWindow.xaml 


回 到 之 前 的 那个 示例 ， 并 执行 下 面 的 操作 。 在 更 改 属性 时 ， 请 注意 观察 这 些 更 改 是 如 何 影 响 XAML 和 设计 
视图 的 。 把 整个 窗口 修改 为 如 图 14-2 所 示 的 样子 。 


图 14-2 


(1 首先 在 设计 视图 中 选中 第 二 个 Button 控件 ， 这 正 是 占 满 整个 窗口 的 那个 按钮 。 

(2) 可 在 Properties 面板 的 项 部 更 改 该 控 件 名 称 ， 将 其 改 为 rotatedButton。 

(3) 在 Common 节点 下 ， 将 Content 的 值 改 为 2nd Button. 

(4) f£ Layout 下 ， 将 Width fll Height 的 值 分 别 更 改 为 75 和 22. 

(5) 展开 Text 节点 ， 单 击 B 图 标 ， 将 文本 改 为 粗 体 。 

(6) 选择 第 一 个 Button 控件 ， 将 其 拖 蝶 到 第 二 个 Button 控件 上 。Visual Studio 会 通过 贴 菲 功能 帮助 调整 控 
件 的 位 置 。 

(7) 再 次 选择 第 二 个 按钮 ， 将 鼠标 指针 巧 停 到 其 左上 角 。 当 指针 变 为 沉 有 箭头 的 四 分 之 一 圆 弧 时 ， 回 下 拖 
忠 ， 使 该 按钮 倾斜。 
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(8) 现在 ， 窗 口 的 XAML 代码 应 该 如 下 所 示 : 

«Window x:Class-"Chl4Ex01.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:Chl4Ex01" 
mc:Ignorable-"d" 

Title-"MainWindow" Height-"350" Width="525"> 
«Grid» 
«Button Content-"Button" HorizontalAlignment-"Left" Margin-"221,115,0,0" 
VerticalAlignment-"Top" Width="75"/> 
«Button x:Name-"rotatedButton" Content-"2nd Button" Width-"75" Height-"22" 
FontWeight-"Bold" RenderTransformOrigin-"0.5,0.5" > 
«Button.RenderTransform- 
<TransformGroup> 
<ScaleTransform/> 
<SkewTransform/> 
<RotateTransform Angle="-32.7/44"/> 
<TranslateTransform/> 
</TransformGroup> 
</Button. RenderTransform> 
</Button> 
</Grid> 
</Window> 


(9) Tz F5 键 运行 该 应 用 程序 ， 并 壬 试 改变 窗口 大 小 。 注 间 ， 第 二 个 按钮 会 随 看 窗口 大 小 的 变化 而 移动 ， 而 
第 一 个 按钮 则 保持 不 动 。 


示例 说 明 

在 三 个 视图 中 ， 任 意 一 个 视图 的 更 改 都 会 目 动 反映 在 其 他 视图 中 ， 但 某 些 视 图 可 能 更 适合 做 某 些 特定 的 调 
整 。 修 改 按钮 上 显示 的 文本 等 不 重要 内 容 时 ， 可 很 快 在 XAML 视图 中 进行 修改 , 但 如 果 要 添加 一 些 用 于 变形 泻 
染 的 代码 ， 则 在 设计 视图 中 调整 会 更 快 。 

在 本 练习 中 ， 我 们 首先 更 改 了 按钮 名 ， 该 操作 为 该 按钮 添加 了 x:Name 属性 。 控 件 的 名 称 必须 在 整个 名 称 
空间 范围 内 是 唯一 的 ， 也 就 是 说 一 个 名 称 只 能 指定 给 一 个 控件 。 

接着 更 改 了 Content 属性 ， 并 设置 了 控件 的 Height 和 Width 属性 ， 以 及 将 字体 更 改 为 粗 体 。 通 过 这 样 的 更 
改 ， 控 件 在 窗口 中 的 外 观 得 到 了 改善 。 在 之 前 ， 该 控件 占 满 了 整个 容器 ， 但 现在 ， 我 们 将 其 限制 为 特定 大 小 。 

随后 将 第 一 个 按钮 拖 电 到 设计 视图 中 的 特定 位 置 。 如 本 章 后 面 所 述 ， 这 样 的 操作 并 不 总 是 得 到 相同 的 
结果 ， 而 会 根据 控件 所 处 的 容器 而 有 所 不 同 。 在 本 例 中 ， 由 于 有 了 Grid 容器 ， 可 将 控件 抑 蝶 到 特定 位 置 。 
拖 电 操作 会 设置 控件 的 Margin 属性 。 同 时 ， 还 需要 注意 另外 两 个 属性 : HoriontalAlignment-"Left" Fil 
VerticalAlignmenf=-"Top"。 设 置 上 述 两 个 属性 后 ， 该 控件 的 四 周 留 日 将 相对 于 窗口 的 堪 上 角 而 定 ， 并 且 将 保留 
在 所 放置 的 那个 网 格 位 置 中 。 如 果 此 时 对 比 第 一 个 按钮 和 第 二 个 按钮 ， 将 注意 到 ， 第 二 个 控件 并 未 设置 上 述 
属性 。 正 是 由 于 没有 设置 Alignment 和 Margin 属性 , 该 控件 才 会 停留 在 容器 的 中 间 , 即使 是 在 运行 时 也 是 这 样 。 
也 就 是 说 ， 己 经 设置 了 Alignment 和 Margin 属性 的 第 一 个 按钮 在 窗口 大 小 改变 时 会 固定 在 窗口 中 的 特定 位 置 ， 
而 第 二 个 按钮 始终 体 持 在 窗口 中 间 。 

最 后 一 个 步 又 中 做 了 轻微 修改 。 通 过 在 “旋转 ”鼠标 指针 出 现 的 位 置 拖 忠 控件 ， 可 以 旋转 该 控件 。 这 是 
XAML 和 WPF 的 一 个 标准 功能 ， 可 应 用 到 所 有 控件 中 ， 不 过 极 少 数控 件 在 旋转 后 不 会 对 目 己 内 部 的 内 容 做 
相应 调整 。 这 主要 是 那些 依赖 Windows Form 或 旧 Windows 控件 来 显示 内 容 的 控件 。 

在 WPF 中 可 以 进行 的 变形 操作 将 在 第 15 章 中 进行 介绍 ， 但 通过 拖 忠 鼠标 日 动 生成 的 XML 人 代码， 我们 可 
以 看 到 ， 只 需要 控制 这 些 属性 ， 就 可 以 执行 一 些 高 级 动画 效果 。 

1. 依赖 属性 

用 户 在 对 话 框 中 执行 的 一 些 操 作 (如 选择 列表 项 ) 往 往 会 导致 其 他 控件 改变 和 更 新 其 外 观 显示 或 内 容 。 大 多 
数 情 况 下 ， 标 准 .NET 属性 都 是 简单 的 设置 右 和 获取 器 ， 这 可 能 无 法 将 所 做 的 更 改 告 知 给 其 他 控件 。 依 赖 属性 
(Dependency Property) 是 一 种 能 够 注册 到 WPF 属性 系统 中 的 属性 ， 据 此 可 以 获得 更 多 功能 。 这 些 功能 包括 目 动 
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属性 更 改 通知 ， 但 此 外 有 其 他 很 多 好 处 。 有 具体 说 来 ， 依 赖 属 性 的 功能 包括 : 
e 可 通过 样式 来 更 改 依赖 属性 的 值 。 
可 在 动画 中 更 改 依赖 属 性 的 值 。 
可 按 层级 结构 设置 XAML 中 的 依赖 属性 。 也 就 是 说 ， 设 置 茶 个 父 元 系 中 依赖 属性 的 值 时 ， 可 将 该 值 也 
作为 其 子 元 系 中 辐 一 个 依赖 属性 的 默认 值 。 
e 可 通过 明确 定义 的 代码 模式 ， 来 配置 属性 值 更 改 通 知 。 
e 可 配置 一 系列 相关 属性 ， 其 中 一 个 属性 值 改 变 后， 会 目 动 更 新 其 他 属性 。 这 种 功能 称 为 强制 (coercion)。 
这 样 的 操作 通 第 称 为 被 更 改 的 属性 强制 其 他 属性 的 值 友 生变 化 。 
e 可 对 依赖 属性 应 用 元 数据 ， 以 便 指 定 其 他 行为 特征 。 例 如 ， 我 们 可 以 指定 ， 如 果 给 定 的 属性 值 发 生变 
化 ， 束 目 动 调整 用 户 界 面 。 
在 实践 中 ， 由 于 依赖 属性 都 通过 特定 的 方法 来 实现 ， 因 此 我 们 可 能 不 会 注意 到 它们 与 普通 属性 有 太 大 的 区 
别 。 但 当 我 们 创建 目 己 的 控件 时 ， 很 快 会 发 现在 使 用 普通 .NET 属性 时 ， 很 多 功能 突然 间 就 消失 不 见 了 。 
第 15 章 将 介绍 如 何 实现 新 的 依赖 属性 。 


2. 附加 属性 
附加 属性 (Attached Property) 是 一 种 在 定义 该 属性 的 类 实例 的 每 个 子 对 象 上 都 可 用 的 属性 。 例 如 ， 如 本 章 
稍 后 所 述 ， 在 之 前 的 示例 中 用 到 的 Grid 控件 可 以 定义 列 和 行 ， 以 便 对 Grid 控件 的 子 控件 进行 排序 。 这 样 ， 每 
个 子 控件 就 都 可 以 使 用 Column 和 Row 这 两 个 附加 属性 来 指定 目 己 属于 网 格 中 的 哪 一 个 单元 格 了: 
<Grid HorizontalAlignment="Left" Height="167" VerticalAlignment="Top" Width="290"> 
«Button Content-"Button" HorizontalAlignment-"Left" Margin-"10,10,0,0" 


VerticalAlignment-"Top" Width-"75" Grid.Column="0" Grid.Row="0" 
Height-"22" /» 


</Grid> 
在 这 段 代码 中 ， 引 用 附加 属性 的 做 法 是 使 用 父 元 素 的 名 称 ， 加 上 一 个 句点 ， 后 跟 附加 属性 的 名 称 。 
在 WPF 中 ， 附 加 属性 有 很 多 用 处 。 在 稍 后 的 14.3 节 “ 控 件 布局 ”中 可 以 看 到 许多 通过 附加 属性 来 指定 控 
件 位 置 的 例子 。 同 样 ， 我 们 也 将 学 习 如 何在 容 占 控件 中 定义 附加 属性 ， 使 子 控件 可 以 定义 请 如 日 己 要 贴 菲 到 容 
器 哪 一 侧 这 样 的 属性 。 


14.2.3 事件 


第 13 章 介 绍 了 什么 是 事件 ， 以 及 如 何 使 用 它们 。 本 节 专 门 讨论 由 WPF 控件 生成 的 事件 ， 还 将 介绍 一 种 通 
币 与 用 户 操作 关联 的 路 由 事件 Gouted evenb。 例 如 ， 当 用 户 单 击 茶 个 按钮 时 ， 该 按钮 会 生成 一 个 事件 ， 用 于 表 
明 目 身 及 生 了 什么 。 通 过 处 理 该 事件 ， 程 序 员 可 为 该 按钮 提供 某 种 功能 。 

我 们 要 处 理 的 大 部 分 事件 都 是 本 书 中 所 涉及 控件 的 通用 事件 ， 例 如 LostFocus 和 MouseEnter 等 。 这 有 是 因为 
这 些 事件 本 身 继 承 目 诸如 Control 或 ContentControl 的 基 类 。 此 外 , f& DatePicker 控件 的 CalendarOpened 事件 是 
专用 事件 ， 只 存在 于 特定 的 控件 中 。 表 14-1 列 出 了 一 些 最 常用 的 事件 。 


表 14-1 通用 控件 事件 


事 件 说 RA 
Click 当 控 件 被 单 击 时 发 生 。 茶 些 情 况 下 ， 当 用 户 按 下 Enter 键 时 也 会 发 生 这 样 的 事件 
Drop 当 拖 蝶 操 作 完 成 时 发 生 ， 也 就 是 说 ， 当 用 户 将 茶 个 对 象 拖 蝶 到 该 控件 上 ， 然 后 松 开 忌 标 按钮 时 发 生 
DragEnter 当 茶 个 对 象 被 拖 忠 进入 该 控件 的 边缘 范围 内 时 发 生 
DragLeave ELEME 3/5; BS FI Fl ZT ARE 


DragOver SFR TOT FC Ha BR Be PF EB AE 
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a + "EET 
KeyDown 当 该 控件 具有 焦点 ， 并 且 某 个 按键 被 按 下 时 发 生 。 该 事件 总 在 KeyPress 和 KeyUp 事件 之 前 发 生 
KeyUp 当 该 控件 具有 焦点 ， 并 且 某 个 按键 被 释放 时 发 生 。 该 事件 总 在 KeyDown 事件 后 发 生 
GotFocus 当 该 控件 获得 焦点 时 发 生 。 勿 用 该 事件 对 控件 执行 验证 操作 。 应 该 改 用 Validating 和 Validated 
LostFocus 当 该 控件 失去 焦点 时 发 生 。 请 勿 使 用 该 事件 对 控件 执行 验证 操作 。 应 该 改 用 Validating 和 Validated 


MouseDoubleClick 当 双 击 该 控件 时 发 生 
当 鼠 标 指针 经 过 某 个 控件 ， 和 鼠标 按钮 被 按 下 时 发 生 。 该 事件 与 Click 事件 并 不 相同 ， 因 为 MouseDown 事 


MouseDown 
件 在 按钮 被 按 下 后 ， 在 其 释放 前 发 生 
MouseMove 当 鼠 标 经 过 控件 时 持续 发 生 
MouseUp 当 鼠 标 指针 经 过 控件 ， 而 鼠标 按钮 又 被 释放 时 发 生 


在 本 章 的 示例 中 将 多 次 遇 到 上 述 这 些 事件 。 
1. 处 理事 件 


为 事件 添加 处 理 程 序 有 两 种 基本 方式 。 其 一 是 使 用 Properties 窗口 中 的 事件 列表 ， 如 图 14-3 所 示 。 当 单 击 
Properties 窗口 中 的 内 电 按 钮 时 ， 束 会 出 现 事件 列表 。 


Name | rotatedButton 


Type Button 
Click | | zs 
ContextMenuClosing | ”| 
ContextMenuOpeni... | | 
DataContextChanged Po 
DragEnter 
DragLeave 
DragOver 
Drop 
FocusableChanged 
GiveFeedback 


GotFocus 


GotKeyboardFocus 


GotMouseCapture 
GotStylusCapture 
GotTouchCapture 


Z] 14-3 


要 为 特定 事件 添加 处 理 程序 ， 可 以 输入 事件 名 ， 然 后 按 回 车 键 ， 也 可 以 在 事件 列表 中 事件 名 的 右 侧 双 击 。 
该 操作 会 将 相应 事件 添加 到 XAML 标签 中 。 而 处 理 该 事件 的 相应 方法 的 签名 则 被 添加 到 C# 代 码 隐 藏 文件 中 。 
«Button x:Name-"rotatedButton" Content-"2nd Button" Width="75" 
Height-"22" FontWeight-"Bold" Margin-"218,138,224,159" 


RenderTransformorigin="0.5,0.5" 
Click="rotatedButton Click"> 


</Button> 
private void rotatedButton Click(object sender, RoutedEventArgs e) 


} 
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另外 ,还 可 以 直接 在 XAML 中 输入 事件 名 , 并 添加 相应 的 处 理 程序 的 名 称 。 如 果 使 用 这 种 方法 , Visual Studio 
将 在 你 进行 输入 时 显示 一 个 New Event Handler 菜单 选择 该 菜单 可 为 事件 提供 默认 的 名 称 并 在 代码 隐藏 文件 中 
创建 事件 处 理 程序 。 如 果 自 己 输入 事件 名 ， 可 在 以 后 右 击 该 事件 ， 然 后 选择 Go To Definition， 在 代码 中 生成 事 
件 处 理 程序 。 


2. 路 由 事件 


WPF 中 存在 一 种 路 由 事件 Couted evenb。 标 准 的 NET 事件 会 被 显 式 订阅 该 事件 的 代码 处 理 ， 且 只 发 送 到 这 
些 订 阅 者 那里 。 路 由 事件 的 不 同 之 处 在 于 ， 可 将 事件 发 送 到 包含 该 控件 所 在 层次 的 所 有 控件 。 

当 路 由 事件 及 生 时 ， 它 会 回 发 生 该 事件 的 控件 的 上 层 与 下 层 控件 传递 。 也 惑 是 说 ， 如 果 右 击 了 茶 个 按钮 ， 
会 首先 将 MouseRightButtonDown 事件 发 送 给 该 按钮 本 身 ， 然 后 友 送 给 该 控件 的 父 控件 ， 在 之 前 的 示例 中 ， 惑 
是 Grid 控件 。 如 果 Grid 控件 未 处 理 该 事件， 该 事件 会 最 终 传 递 给 窗口 。 如 果 不 升 望 该 事件 被 继续 传 往 更 局 的 
控件 层次 ， 只 需要 将 RoutedEventArgs 的 属性 Handled 设置 为 tue 即 可 ， 此 时 不 会 再 肥 生 其 他 调用 。 当 茶 个 事 
件 像 这 样 往 上 层 传 递 时 ， 就 称 其 为 冒 泡 事件 (bubbling event). 

路 由 事件 也 可 以 往 其 他 方 癌 传递 ， 例 如 从 根 元 素 传 往 执行 操作 的 控件 。 这 样 的 事件 被 称 为 下 外 事件 
(tunneling event)， 并 且 按 照 约定 ， 所 有 这 类 事件 都 应 该 加 上 Preview 前 级 ， 并 且 总 是 在 相应 的 冒 泡 事件 之 前 发 
生 。PreviewMouseRightButtonDown 事件 就 属于 这 一 类 。 

最 后 需要 说 明 的 是 ， 路 由 事件 的 行为 也 可 以 和 标准 的 NET 事件 一 样 ， 上 只 友 送 给 执行 操作 的 控件 。 


3. 路 由 命令 


路 由 命令 (routed command) 的 作用 与 事件 相似 ， 痢 是 引起 一 些 代 码 开始 执行 。 但 事件 只 能 直接 与 XAML 中 
的 单个 元 了 系 和 代码 中 的 一 个 处 理 程序 绑 定 ， 路 由 命令 则 更 复杂 。 

事件 和 命令 的 关键 差异 主要 在 使 用 过 程 中 体现 出 来 。 如 宁 一 段 代 码 啊 应 的 是 只 在 应 用 程序 中 的 一 个 位 置 友 
生 的 用 户 操作 ， 则 应 该 使 用 事件 。 例 如 ， 当 用 户 单 击 茶 个 窗口 中 的 OK 按钮 以 便 保 存 并 关闭 该 窗口 时 ， 台 使 用 
此 类 事件 。 当 代码 啊 应 多 个 位 置 的 操作 时 ， 则 应 该 使 用 命令 。 例 如 ,很 多 时 候 ， 既 可 以 在 菜单 中 选择 Save fi 
也 可 以 使 用 茶 个 工具 栏 按钮 来 保存 应 用 程序 的 内 容 。 这 样 的 需求 实际 上 也 可 以 使 用 事件 处 理 程序 来 完成 ， 但 这 
意味 看 我 们 需要 在 许多 地 方 编写 相同 的 代码; 而 使 用 命令 ， 则 只 需要 编写 一 次 即 可 。 

在 创建 命令 时 , 还 需要 通过 一 些 代码 来 回答 这 样 一 个 问题 :“ 当 前 是 任 允 许 用 尸 使 用 这 段 代 码 ? "Boe 
将 一 个 命令 与 条 个 按钮 关联 起 来 时 ， 访 按钮 可 以 询问 这 个 命令 能 全 执行 ， 并 相应 地 设置 其 状态 。 

实现 一 个 命令 比 实现 一 个 事件 更 复杂 ， 所 以 我 们 将 其 放 到 第 15 A, 在 介绍 六 里 项 时 讲解 。 下 面 的 示例 给 
本 章 前 面 的 示例 添加 了 一 些 事件 处 理 程序 ， 演 示 了 路 由 事件 。 


试 一 试 ” 路 由 事件 : Ch14Ex01\MainWindow.xaml 


下 面 的 示例 是 在 本 章 之 前 的 示例 基础 上 完成 的 。 如 果 在 之 前 的 练习 中 添加 了 行 和 列 ， 应 将 它们 删除 挥 ， 以 
便 符合 本 示例 中 XAML 代码 的 要 求 。 

(1) 选择 rotatedButton 按钮 ， 然 后 添加 一 个 KeyDown 事件 。 可 通过 Properties 面板 或 直接 输入 XAML 代码 
的 方法 来 完成 这 一 步骤 。 将 其 售 名 为 rotatedButton KeyDown. 

(2) Æ XAML 视图 中 单 击 Grid 对 应 的 标签 将 其 选中 , 然后 为 其 添加 相同 事件 。 将 其 命名 为 Grid_KeyDown. 

(3) Œ XAML 视图 中 选择 Window 标签 ， 再 次 添加 该 事件 。 将 其 命名 为 Window_KeyDown. 

(4) 重复 步 又 (1) 到 (3)， 所 不 同 的 是 添加 PreviewKeyDown 事件 ， 随 后 修改 事件 的 名 称 ， 表 明 它 是 Preview 

处 理 程序 。 最 终 的 XAML 代码 如 下 所 示 : 

«Window x:Class-"Chl4Ex01.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 


xmlns:local-"clr-namespace:Chl4Ex01" 
mc:Ignorable-"d" 
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Title-"MainWindow" Height="350" Width="525" KeyDown-"Window KeyDown" 
PreviewKeyDown-"Window PreviewKeyDown"> 7 
«Grid KeyDown-"Grid KeyDown" PreviewKeyDown-"Grid PreviewKeyDown"> 
«Button Content-"Button" HorizontalAlignment-"Left" Margin-"221,115,0,0" 
VerticalAlignment-"Top" Width-"75" /> 
«Button x:Name-"rotatedButton" Content-"2nd Button" Width-"75" Height-"22" 
FontWeight-"Bold" RenderTransformOrigin-"0.5,0.5" KeyDown-"rotatedButton 
KeyDown" PreviewKeyDown-"rotatedButton PreviewKeyDown" > 
«Button.RenderTransform- 
<TransformGroup> 
<ScaleTransform/> 
<SkewTransform/> 
<RotateTransform Angle-"-32.744"/» 
<TranslateTransform/> 
</TransformGroup> 
«/Button.RenderTransform- 
«/Button- 
</Grid> 
</Window> 


(5) 如 果 直 接 输 入 XAML 代码 , 则 右 击 每 个 事件 , 通过 选择 Go To Definition XPM Bee CT HP AR 


事件 处 理 程序 。 


BE 


(6) 将 下 列 代码 添加 到 事件 处 理 程序 : 


private void Grid KeyDown(object sender, KeyEventArgs e) 
MessageBox.Show("Grid handler, bubbling up"); 

— void Grid PreviewKeyDown(object sender, KeyEventArgs e) 
MessageBox.Show("Grid handler, tunneling down"); 

T void rotatedButton KeyDown(object sender, KeyEventArgs e) 
MessageBox.Show("rotatedButton handler, bubbling up"); 

pr void rotatedButton PreviewKeyDown (object sender, KeyEventArgs e) 
{ 


MessageBox.Show("rotatedButton handler, tunneling down"); 


ve void Window KeyDown (object sender, KeyEventArgs e) 

i MessageBox. Show ("Window handler, bubbling up"); 

EN void Window PreviewKeyDown(object sender, KeyEventArgs e) 
' MessageBox.Show("Window handler, tunneling down"); 

} 


(7) 按 下 FS 键 运行 该 应 用 程序 
(8) 通过 单 击 并 按 下 任意 键 ( 回 车 键 或 空格 键 除外 ) 的 方式 选择 旋转 后 的 按钮 。 观 察 一 下 事件 的 执行 顺序 。 
(9) 关闭 该 应 用 程序 。 

(10) 找到 Grid PreviewKeyDown 事件 处 理 程序 ， 在 MessageBox 一 行 的 下 方 添加 如 下 代码 : 


e.Handled = true; 


(11) 重复 步 又 (7) 和 (8)。 


示例 说 明 

KeyDown 和 PreviewKeyDown 事件 演示 了 冒 泡 事件 和 下 钻 事件 。 在 选择 rotatedButton 按钮 的 同时 按 下 某 个 
会 看 到 每 个 事件 处 理 程序 被 依次 执行 。 

自 先 执行 Preview 事件 ， 从 Window 对 象 的 处 理 程序 开始 ， 然 后 是 Grid， 最 后 是 rotatedButton 。 随 后 执行 


KeyDown 事件 ， 但 这 次 的 执行 顺序 与 上 面 正 好 相反 ， 从 rotatedButton 按钮 的 事件 处 理 程 序 开始 ， 到 Window 对 
象 的 处 理 程序 结束 。 


按钮 控件 对 回 千 键 和 空格 键 做 了 特殊 处 理 。 这 两 个 按键 会 被 看 成 一 个 Click 事件 ， 因 此 对 于 这 两 个 按键 仅 


会 触发 Preview 事件 。 


随后 添加 了 下 面 这 行 代码 : 
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e.Handled = true; 


该 代码 戏剧 性 地 改变 了 程序 的 执行 方式 。 设 置 RoutedEventArgs 的 Handled 属性 不 仅 会 执行 下 钻 事件 ， 也 


会 执行 冒 泡 事 件 。 对 于 所 有 此 类 事件 来 说 ， 基 本 上 都 是 这 样 的 。 如 果 终 止 执行 Preview 或 “普通 ”事件 处 理 程 
序 中 的 一 种 ， 两 者 都 会 终止 。 
4. 控件 类 型 


如 前 所 述 ， 在 WPF 中 有 很 多 控件 可 供 使 用 。 它 们 分 为 内 容 控件 和 项 控件 两 大 类 。 内 容 控件 (例如 Button f? 
件 ) 有 一 个 Content 属性 ， 可 将 这 个 属性 设置 为 其 他 任意 的 控件 。 也 就 是 说 ， 可 以 决定 控件 的 显示 方式 ， 但 只 能 
在 内 容 中 直接 放置 一 个 控件 。 对 于 项 控件 来 说 ， 可 以 在 其 中 插入 多 个 控件 作为 其 内 容 。Grid 控件 就 是 项 控件 的 
一 个 典型 例子 。 在 创建 用 户 界面 时 ， 会 将 这 两 种 控件 混合 起 来 使 用 。 

除 内 容 控件 和 项 控件 外 ， 还 有 其 他 一 些 类 型 的 控件 不 允许 在 其 中 放置 控件 作为 它们 的 内 容 。Image 控件 就 
属于 这 种 情况 ， 该 控件 只 能 用 来 显示 图 片 。 更 改 控件 的 行为 会 改变 控件 的 作用 。 


14.3 ”控件 布局 


到 这 里 为 止 ， 本 章 使 用 Grid 元 素来 设计 一 些 控件 的 布局 ， 这 主要 是 因为 在 新 建 一 个 WPF 应 用 程序 时 ， 它 
是 默认 的 布局 控件 。 不 过 ， 我 们 还 没有 介绍 这 一 控件 的 所 有 功能 ， 也 没有 介绍 除 此 之 外 其 他 能 用 来 进行 布局 的 
容器 。 本 节 将 进一步 介绍 控件 布局 ， 这 是 WPF 的 一 项 基本 概念 。 


14.3.1 基本 布局 概念 


在 WPF 中 可 使 用 布局 控件 对 窗口 中 的 各 项 进行 布局 。 这 样 的 布局 控件 有 很 多 ， 但 在 开始 使 用 它们 之 前 ， 
应 该 先 了 解 一 些 基本 概念 ， 以 及 Visual Studio 提供 的 一 个 可 视 化 辅助 工具 。 

1. SERIF 

当 某 个 容器 控件 包含 多 个 子 控件 时 ， 这 些 子 控件 会 按 特定 的 堆 基 顺 序 进行 排列 。 如 果 使 用 过 绘图 软件 ， 可 
能 已 经 熟悉 了 这 个 概念 。 我 们 可 以 将 堆 王 顺序 想象 为 ， 每 个 控件 都 包含 在 一 个 玻璃 盘 中 ， 而 容器 包含 一 摆 这 样 
的 玻璃 盘 。 这 样 一 来 ， 容 器 的 外 观看 起 来 就 类 似 于 从 这 些 玻璃 的 上 方 往 下 看 时 的 样子 。 当 容器 中 的 控件 重 登 时 ， 
我 们 看 到 的 最 终结 果 就 由 这 些 玻璃 盘 的 上 下 挫 登 顺序 来 决定 。 如 果 茶 个 控件 位 于 上 层 ， 和 在 重 登 的 部 分 ， 该 控件 
融 是 可 见 的 。 而 下 层 的 控件 则 可 能 会 被 它们 上 层 的 控件 遮挡 住 一 部 分 或 全 部 。 

堆 县 顺序 也 影 啊 在 窗口 中 进行 鼠标 单 击 时 的 点 中 行为 。 如 果 考 虑 控件 的 上 下 堆 县 情况 ， 被 点 中 的 控件 则 总 
是 在 最 上 层 的 那 一 个 。 而 控件 的 堆 著 顺序 则 是 由 这 些 控 件 在 容器 的 子 控件 列表 中 出 现 的 顺序 来 决定 的 。 容 器 中 
的 第 一 个 子 控件 位 于 最 下 方 ， 而 最 后 一 个 子 控 件 则 位 于 最 上 方 。 在 这 两 者 之 间 的 子 控件 则 按照 出 现 的 顺序 目下 
目 上 排列 。 此 外 ， 控 件 的 堆 登 顺序 还 会 对 在 WPF 中 使 用 的 茶 些 布局 控件 产生 其 他 影响 ， 稍 后 将 介绍 相关 内 容 。 

2. 对 齐 、 边 距 、 填 充 和 尺寸 

前 面 的 示例 中 用 到 了 Margin. HorizontalAlignment 和 VerticalAlignment 属性 在 Grid 容器 中 安排 控件 的 位 置 ， 
但 当时 并 没有 对 它们 进行 详细 介绍 。 另 外 ， 我 们 了 解 了 如 何 使 用 Height 和 Width 来 指定 控件 的 尺寸 。 上 述 这 些 
属性 ， 以 及 尚未 介绍 过 的 Padding 属性 一 起 ,在 大 多 数 甚至 所 有 布局 控件 ( 稍 后 将 看 到 ) 中 都 十 分 有 用 ， 只 不 过 它 
们 各 目的 作用 有 所 不 同 。 不 同 的 布局 控件 也 可 对 这 些 属 性 设置 一 些 默认 仁 。 接 下 来 将 会 看 到 许多 相关 的 例子 ， 
不 过 衣 先 了 解 与 此 相关 的 基本 知识 。 

HorizontalAlignment 和 VerticalAlignment 这 两 个 对 齐 属性 确定 控件 的 对 齐 方式 。 可 将 HorizontalAlignment 
WAN Left, Right, Center 或 Stretch. Left 和 Right 用 于 让 控件 对 齐 容 器 有 的 左边 毕 或 右边 绿 ，Center 则 表示 位 
FP li], Stretch 则 目 动 调整 控件 宽度 ， 使 其 接触 到 容器 的 左右 边缘 。VerticalAlignment 与 此 类 似 ， 但 值 为 Top. 
Bottom、Center 或 Stretch。 
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Margin 和 Padding 分 别 用 于 指定 控件 边缘 外 侧 和 内 侧 的 留 白 ,之 前 的 示例 使 用 Margin 属性 让 控件 与 窗口 的 
边 绿 保持 一 定 距离 。 由 于 还 将 HorizontalAlignment 设置 为 Left，VerticalAlignment 设置 为 Top， 因 此 控件 会 保持 
在 左上 角 特 定 的 位 置 上 ，Margin 属性 使 其 与 容器 边缘 保持 了 一 定 的 距离 。Padding 与 此 类 似 ， 所 不 同 的 上 只 是 它 
用 来 指定 控件 内 容 与 控件 边缘 的 距离 。 这 对 于 指定 控件 的 Border 比较 有 用 , 下 一 节 将 介绍 Border 控件 。 Padding 
和 Margin 可 按照 四 个 方 回 来 指定 (形式 为 leftAmount、topAmount、rightAmount、bottomAmounnh， 也 可 以 指定 
一 个 值 (Thickness 值 )。 

稍 后 ,你 将 了 解 到 Height 和 Width 属性 往往 被 其 他 属性 所 控制 .例如 , “4 HorizontalAlignment 设置 为 Stretch 
时 ， 控 件 的 Width 属性 就 会 随 看 容器 宽度 的 改变 而 改变 。 

3. Border 控件 

Border 控件 是 一 种 非常 简单 ， 却 非常 有 用 的 容器 控件 。 它 内 含 一 个 子 对 象 ， 而 不 像 稍 后 将 介绍 的 其 他 复杂 
控件 那样 内 含 多 个 子 对 象 。 这 个 子 对 象 会 完全 充满 整个 Border 控件 。 这 看 起 来 不 是 特别 有 用 ,但 请 记 住 ， 可 使 
用 Margin 和 Padding 属性 来 指定 Border 在 其 容器 中 的 位 置 ， 以 及 Border 中 的 内 容 相 对 于 Border ANE. 
还 可 以 为 Border 设置 诸如 Background 的 属性 ， 使 其 可 见 。 接 下 来 将 实际 使 用 这 一 控件 。 

4. 可 视 化 的 调试 工具 

在 调试 模式 下 运行 WPF 应 用 程序 时 ，Visual Studio 会 在 应 用 程序 上 方 ， 窗 口 项 部 的 中 心 位 置 显 示 一 个 小 的 
4 丘 状 的 沫 里 。 在 这 4 PSH, A 3 个 可 以 局 用 或 禁用 调试 功能 ， 还 有 一 个 可 以 打开 Live Visual Trees F 
面 的 示例 以 前 面 的 示例 为 基础 ， 演 示 了 这 个 可 视 化 工具 。 


试 一 试 ” 使 用 可 视 化 的 调试 工具 : Ch14Ex01\MainWindow.xaml 


现在 回头 看 看 本 章 中 的 第 一 个 示例 并 执行 如 下 步骤: 

(1) JÈ F5 键 在 调试 模式 下 运行 该 应 用 程序 。 

(2) 单 击 send 菜单 项 ， 尼 用 Enable Selection 选项 。 

(3) 单 击 文本 为 2nd button 的 按钮 。 注 意 按钮 会 显示 红色 虚线 边框 线 。 

(4) PERAKE, $T7T Live Visual Tree. 

(5) 在 Visual Studio "FP, Live Visual Tree 选项 卡 位 于 左边 ， 单 击 展 开 它 。 

(6) 取决 于 单 击 按钮 的 位 置 ，Live Visual Tree 要 么 选中 TextBlock， 要 么 选中 rotatedButton. 

(7) Œ Live Visual Tree 中 右 击 rotatedButton 并 选择 Show Properties， 这 将 打开 Live Properties Explorer. fF 
其 中 可 看 到 控件 在 运行 期 间 的 属性 。 

(8) 单 击 MainWindow， 使 运行 痢 的 应 用 程序 重新 回 到 Visual Studio 上 方 。 

(9) 单 击 最 右边 的 末 蛙 项 Track Focused Element. 

(10) 单 击 文本 为 Button 的 按钮 ， 可 以 看 到 Live Properties Explorer 中 值 发 生变 化 ， 反 映 了 新 的 选择 。 如 果 
44 H Track Focused Element 六 单项 ， 则 在 完成 新 的 选择 后 ，Live Properties Explorer 中 的 内 容 不 会 发 生变 化 。 

(11) 最 后 ， 局 用 Display Layout Adorners 3i 5f JJ . 

(12) 将 鼠标 巧 停 在 界面 上 的 不 同 元 系 上 , 可 以 看 到 Visual Studio 中 显示 了 一 些 线 , 说 明了 应 用 边 距 的 方式 。 


示例 说 明 

可 视 化 的 调试 工具 对 于 查看 应 用 程序 的 UI 在 运行 时 的 行为 非常 有 用 。 判 断 UI 元 素 在 运行 时 为 什么 表现 出 
特定 的 行为 是 很 难 的 ， 但 借助 这 些 工 具 ， 可 深入 研究 并 检查 在 应 用 程序 执行 时 ， 实 际 应 用 的 这 些 控件 的 属性 。 
14.3.2. 布局 面板 

所 有 内 容 布局 控件 都 继承 目 抽象 类 Panel. AE MINA ae n] AIRE A UIElement 的 对 象 的 集合 。 所 有 
WPF 控件 都 继承 自 UIElement。 我 们 不 能 直接 使 用 Panel 类 对 控件 进行 布局 ， 但 可 以 从 它 派 生出 其 他 需要 的 控 
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件 。 男 外 ， 可 直接 使 用 以 下 这 些 继承 日 Panel 的 布局 控件 ， 如 表 14-2 所 示 ， 其 中 列 出 了 大 多 数 常 用 的 布局 面板 。 


表 14-2 常用 的 布局 面板 


布局 面板 说 明 

Canvas 该 控件 允许 以 任何 合适 的 方式 放置 子 控件 。 它 不 会 对 子 控件 的 位 置 施加 任何 限制 , 但 不 会 对 位 置 摆 放 提供 任 
何 辅助 

DockPanel 该 控件 可 让 其 中 的 子 控件 贴 靠 到 自己 四 条 边 中 的 任意 一 边 。 最 后 一 个 子 控件 则 可 以 充满 剩余 区 域 

Grid 该 控件 让 子 控件 的 定位 变 得 比较 灵活 。 可 将 该 控件 的 布局 分 为 右 干 行 和 者 干 列 ， 这 样 就 可 以 在 网 格 布 局 中 对 
齐 控件 

StackPanel 该 控件 能 够 按照 水 平方 向 或 垂直 方向 依次 对 子 控件 进行 排列 

WrapPanel 与 StackPanel —#F, AIR HERE RROK FA AREEN IRMKDOS T $24 EET AP, 但 它 不 是 按照 一 行 或 一 列 


来 排序 ， 而 是 根据 可 用 空间 的 大 小 以 多 行 多 列 的 方式 来 排列 


1. Canvas 控件 

Canvas 控件 可 以 完全 上 日 由 地 对 控件 的 位 置 进行 安排 。 同 时 ， 对 Canvas IJ T- 7638 LR] HorizontalAligment 和 
VerticalAlignment 属性 并 不 会 改变 这 些 元 系 的 位 置 。 

如 之 前 的 例子 所 示 , 可 使 用 Margin 属性 来 定位 元 素 , 但 最 好 使 用 Canvas 类 公开 的 Canvas.Left、 Canvas.Top、 
Canvas.Right 和 Canvas.Bottom 附加 属性 。 

<CanVasS...> 


«Button Canvas.Top="10" Canvas. Left="10"...>Buttonl</Button> 
</Canvas> 


上 面 这 段 代 码 将 Button 控件 定位 到 距离 Canvas 控件 项 部 和 左 侧 各 10 像素 的 位 置 。 需 要 注意 ，Top 和 Left 
属性 的 优先 级 高 于 Bottom 和 Right 局 性。 例如， 如果 同时 指定 Top 和 Bottom 属性 ，Bottom JR VES 1 AaB TE 
图 14-4 分 别 展示 了 在 Canvas 控件 中 放置 两 个 Rectangle 控件 ， 并 将 窗口 调整 为 两 种 不 同 大 小 后 的 情形 。 


B ' Canvas 


图 144 


注意 : 
本 节 中 所 有 示例 布局 都 可 在 本 章 对 应 的 下 载 代码 的 LayoutExamples 项 目 中 找到 。 可 以 通过 本 章 开 头 的 “本 
章 源 代码 下 载 ” 部 分 了 解 如 何 下 载 本 章 代码 。 


其 中 一 个 Rectangle 控件 的 位 置 相 对 于 左上 角 进 行 设置 ， 而 另 一 个 则 相对 于 右 下 有 角 进 行 设 置 。 调 整 窗口 大 小 
时 ， 它 们 各 自 的 相对 位 置 保持 不 变 。 还 可 以 看 到 Rectangle 控件 堆 芭 顺序 的 重要 性 。 右 下 角 的 Rectangle 控件 位 
于 上 层 ， 所 以 当 两 者 重 登 时 ， 用 户 看 到 的 是 这 个 控件 。 

本 示例 的 代码 如 下 所 示 ( 可 在 LayoutExamples\Canvas.xaml 下 载 文件 中 找到 ): 
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«Window x:Class-"LayoutExamples.Canvas" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:LayoutExamples" 
mc:Ignorable-"d" 

Title-"Canvas" Height-"300" Width="300"> 
«Canvas Background="AliceBlue"> 
«Rectangle Canvas.Left-"50" Canvas.Top-"50" Height-"40" Widtn-"100" 
Stroke-"Black" Fill-"Chocolate" /> 
«Rectangle Canvas.Right-"50" Canvas.Bottom-"50" Height="40" Width="100" 
Stroke-"Black" Fill-"Bisque" /> 
</Canvas> 
< /Window> 


2. DockPanel 控件 


顾名思义 ，DockPanel 控件 允许 将 控件 贴 靠 到 某 条 边 上 。 就 算 之 前 我 们 没有 特别 注意 过 这 样 的 布局 方式 ， 
也 应 该 十 分 熟悉 此 类 布局 。 例 如 ，Word 软件 中 的 功能 区 (Ribbon) 控 件 就 停留 在 Word 窗口 项 部 ，Visual Studio 中 
的 各 种 窗口 也 各 目 停 靠 在 不 同位 置 上 。 并 且 ， 可 以 拖 动 Visual Studio 中 的 这 些 窗 口 ， 改 变 它们 的 停靠 位 置 。 

DockPanel 具有 一 个 能 让 子 控件 用 来 指定 停靠 边缘 的 附加 属性 ， 即 DockPanelDock。 可 将 该 属性 的 值 设置 
VJ Left. Top. Right 或 Bottom. 

DockPanel PIR HY SE SEU AES BE, BASES TEE ESI USER Ea, Hi Pe FF ay AA 
间 就 会 减少 。 例 如 ， 将 一 个 工具 栏 控 件 停靠 到 DockPanel 的 顶部 ， 然 后 将 另 一 个 工具 栏 停靠 到 DockPanel 的 左 
边 。 这 样 一 来 ， 第 一 个 控件 就 会 占 满 DockPanel 显示 区 域 的 整个 顶部， 而 第 二 个 控件 则 只 能 占 满 第 一 个 控件 的 
底部 到 DockPanel 控件 压 部 的 左 侧 区 域 。 

最 后 一 个 子 控件 通 沼 将 只 能 占 满 其 他 子 控件 之 外 余下 部 分 的 相应 区 域 (可 控制 这 一 行为 , 所 以 前 面 这 句 话 并 
不 是 完全 肯定 的 语气 )。 

在 DockPanel 中 定位 一 个 控件 时 ， 该 控件 所 占用 的 区 域 可 能 会 小 于 DockPanel 为 其 保留 的 区 域 。 例 如 ， 如 
Fok — AS BE7g 100. fA 50. HorizontalAlingment 的 值 为 Left 的 Button 控件 停靠 到 DockPanel 的 顶部， 在 
Button 的 右 侧 就 会 留 下 一 部 分 无 法 被 其 他 仿 徘 子 控件 占用 的 区 域 。 并 且 ， 如 果 Button 控件 的 Margin (67 20, 
DockPanel 顶部 被 保留 的 区 域 就 有 90 fx ra GEB RES E PAA] Margin 值 相 加 )。 在 使 用 DockPanel 设置 
布局 时 ， 务 必 考 虑 这 些 因 系 ; 否则 可 能 无 法 获得 预想 的 结果 。 

图 14-5 展示 了 一 个 DockPanel 布局 示例 。 


B" DockPanels 


5) Last control 


4) DockPanel.Dock- "Bottom" 


图 14-5 


这 一 布局 的 代码 如 下 所 示 ( 可 在 LayoutExamples DockPanel.xaml 下 载 文件 中 找到 ) : 


«Window x:Class-"LayoutExamples.DockPanels" 
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xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:LayoutExamples" 
mc:Ignorable-"d" 
Title-"DockPanels" Height="300" Width="300"> 
«DockPanel Background="AliceBlue"> 
«Border DockPanel.Dock-"Top" Padding-"10" Margin="5" 
Background-"Aquamarine" Height="45"> 
<Label>1) DockPanel.Dock-"Top"«/Label» 
«/Border- 
«Border DockPanel.Dock-"Top" Padding-"10" Margin-"5" 
Background-"PaleVioletRed" Height-"45" Width="200"> 
<Label>2) DockPanel.Dock="Top"</Label> 
</Border> 
<Border DockPanel.Dock="Left" Padding="10" Margin="5" 
Background-"Bisque" Width="200"> 
<Label>3) DockPanel.Dock="Left"</Label> 
</Border> 
<Border DockPanel.Dock="Bottom" Padding="10" Margin="5" 
Background-"Ivory" Width-"200" HorizontalAlignment="Right"> 
<Label>4) DockPanel.Dock="Bottom"</Label> 
</Border> 
«Border Padding-"10" Margin-"5" Background-"BlueViolet"- 
«Label Foreground="White">5) Last control</Label> 
</Border> 
</DockPanel> 
</Window> 


上 述 代 码 使 用 前 面 介绍 的 Border 控件 标记 出 示例 布局 中 停靠 控件 的 区 域 ， 并 使 用 Label HHn di — E faj Re 
的 朱 述 性 文字 。 要 了 解 整 个 布局 ， 必 须 从 头 到 尾 阅读 这 段 代码 ， 下 面 分 别 来 看 看 每 个 控件 的 情况 : 

(1) 第 1 个 Border 控件 停靠 于 DockPanel 控件 的 顶部 。DockPanel 中 被 占 去 的 区 域 为 顶部 的 55 像素 (Height 
加 上 两 个 Margin)。 需 要 注意 ，Padding 属性 不 影响 这 一 布局 ， 因 为 该 属性 只 会 应 用 到 Border 的 内 部 ， 并 不 能 
控制 嵌入 的 Label 控件 的 位 置 。 如 果 未 指定 Height 或 Width 属性 ，Border 控件 会 占 满 其 所 停靠 边缘 的 整个 可 用 
区 域 ， 这 就 是 为 什么 它 会 横 跨 整个 DockPanel 控件 的 原因 。 

(2) 第 2 个 Border 控件 同样 停 菲 到 DockPanel 的 顶部 ,并 占用 了 剩 下 部 分 项 部 的 55 像素 高 的 区 域 。 该 Border 
控件 还 有 一 个 Width 属性 ， 这 就 使 其 仪 占用 了 DockPanel 一 部 分 的 宽度 。DockPanel 中 HorizonalAlignment 属性 
的 默认 值 为 Center， 所 以 它 位 于 DockPanel If] FIA]. 

(3) 第 3 个 Border 控件 停靠 到 DockPanel 的 左 侧 ， 占 用 了 左 侧 210 像素 的 区 域 。 

(4) 第 4 个 Border 控件 停 菲 在 DockPanel ER, 占用 的 区 域 为 30 像素 加 上 其 中 的 Label 控件 (也 可 以 是 其 他 
FETA RE. irae EH Margin, Padding 和 Border 控件 的 内 容 共 同 决 定 ， 并 没有 明确 指定 。Border 控件 被 固定 
到 DockPanel 的 右 下 角 ， 因 为 其 HorizontalAlignment 值 为 Right. 

(5) 第 5 个 (也 就 是 最 后 一 个 Border 控件 ) 占 满 了 其 他 所 有 区 域 。 

运行 该 示例 ， 然 后 试 痢 调整 内 容 的 大 小 。 注 意 ， 控 件 在 堆 登 顺序 中 越 接近 项 层 ， 融 越 具 有 占用 衬 间 的 优先 
权 。 在 缩小 窗口 时 ， 第 5 个 Border 控件 可 能 会 被 上 层 的 其 他 所 有 控件 完全 遮 兰 。 所 以 注意 在 使 用 DockPanel 控 
件 进行 布局 时 避免 这 种 情况 的 发 生 ， 例 如 可 为 窗口 设置 允许 的 最 小 尺寸 。 


3. StackPanel 控件 


可 将 StackPanel 控件 理解 为 精简 版 的 DockPanel， 即 子 控件 所 停靠 的 边缘 是 固定 不 变 的 。 另 一 个 差异 是 
StackPanel 中 的 最 后 一 个 子 控 件 不 会 占 满 剩 余 空 间 。 不 过 ， 这 些 子 控件 默认 情况 下 会 拉 伸 到 StackPanel 控件 的 

控件 的 堆 登 方 同 由 三 个 属性 决定 。Orientation 可 设置 为 Horizontal 或 Vertical, HorizontalAlignment 和 
VerticalAlignment 可 用 于 决定 控件 的 堆栈 是 紧 靠 StackPanel 的 顶部 、 底 部 、 左 侧 还 是 右 侧 进行 排列 。 还 可 将 对 
J (Alignment jE EHE i AJJ Center, LERF StackPanel 的 中 间 堆 县。 

图 14-6 展示 了 两 个 StackPanel 控件 ， 其 中 分 别 包含 三 个 按钮 。 上 方 的 StackPanel 控件 的 Orientation 属性 设 
置 为 Horizontal， 下 方 的 StackPanel 控件 的 Orientation 属性 则 设置 为 Vertical。 
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B StackPanels 


14-6 


此 处 所 用 到 的 代码 如 下 所 示 ( 可 在 LayoutExamples\StackPanels.xaml 下 载 文 件 中 找到 ): 


«Window x:Class-"LayoutExamples.StackPanels" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:LayoutExamples" 
mc:Ignorable-"d" 

Title-"StackPanels" Height-"300" Width="300"> 
«Grid» 
«StackPanel HorizontalAlignment-"Left" Height-"128" VerticalAlignment-"Top" 

Width-"284" Orientation-"Horizontal"- 

«Button Content-"Button" Height-"128" VerticalAlignment-"Top" 
Width="75"/> 
«Button Content-"Button" Height-"128" VerticalAlignment-"Top" 
Width="75"/> 
«Button Content-"Button" Height-"128" VerticalAlignment-"Top" 
Width="75"/> 
</StackPanel> 
<StackPanel HorizontalAlignment="Left" Height="128" VerticalAlignment="Top" 
Width="284" Margin="0,128,0,0" Orientation="Vertical"> 
«Button Content-"Button" HorizontalAlignment-"Left" Width="284"/> 
«Button Content-"Button" HorizontalAlignment-"Left" Width="284"/> 
«Button Content-"Button" HorizontalAlignment-"Left" Width="284"/> 
</StackPanel> 
</Grid> 
< /Window> 


4. WrapPanel 控件 


WrapPanel 基本 上 可 以 认为 是 StackPanel 的 扩展 版 本 ; 容纳 不 下 的 控件 会 被 安排 到 下 一 行 (或 下 一 列 。 图 14-7 
展示 了 一 个 包含 多 个 形状 的 WrapPanel 控件 ， 其 窗口 被 调整 为 两 种 不 同 大 小 。 


| & * WrapPanel 


实现 该 效果 的 代码 如 下 所 示 ( 可 在 LayoutExamples WrapPanel.xaml 下 载 文 件 中 找到 ): 


«Window x:Class-"LayoutExamples.WrapPanel" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:LayoutExamples" 
mc:Ignorable-"d" 

Title-"WrapPanel" Height-"92" Width="260"> 


306 | 第 中 部 分 Windows 编程 


«WrapPanel Background="AliceBlue"> 

«Rectangle Fill="#FF000000" Height-"50" Width="50" Stroke-"Black" 
RadiusX-"10" RadiusY-"10" /> 

«Rectangle Fill="#FF111111" Height="50" Width="50" Stroke-"Black" 
RadiusX-"10" Radiusy="10" /> 

«Rectangle Fill="#FF222222" Height="50" Width="50" Stroke-"Black" 
RadiusX-"10" RadiusY-"10" /> 

«Rectangle Fill="#FFFFFFFF" Height-"50" Width="50" Stroke-"Black" 
RadiusX-"10" RadiusY-"10" /> 


</WrapPanel> 
</Window> 
WrapPanel 控件 是 创建 动态 布局 的 好 方法 ， 使 用 户 可 以 精确 地 控制 内 容 的 显示 。 
5. Grid 控件 


Grid 控件 可 分 为 多 行 和 多 列 ， 以 便 摆 放 子 控件 。 本 章 已 经 多 次 提 到 Grid 控件 了 , 但 每 次 都 只 使 用 一 行 和 一 
列 而 已 。 要 添加 更 多 行 和 列 , 可 使 用 RowDefinitions 和 ColumnDefinitions 属性 , 这 两 个 属性 分 别 是 RowDefinition 
和 ColumnDefinition 对 象 的 集合 ， 而 且 是 通过 属性 元 素 语 法 来 指定 的 : 

<Grid> 

<Grid.RowDefinitions> 
<RowDefinition /> 
<RowDefinition /> 
</Grid.RowDefinitions> 
«Grid.ColumnDefinitions- 
«ColumnDefinition /» 
<ColumnDefinition /> 
</Grid.ColumnDefinitions> 

eibsids 

上 述 代 码 定 义 了 一 个 包含 两 行 和 两 列 的 Grid 控件 。 注意， 这 里 并 不 需要 其 他 信息 ; 每 一 行 和 每 一 列 都 会 随 
着 Grid 控件 大 小 的 改变 而 自动 改变 大 小 。 每 一 行 占用 Grid 中 三 分 之 一 的 高 度 ， 每 一 列 则 占用 其 一 半 的 宽度 。 
通过 将 Grid.ShowGridlines 属性 设置 为 tue， 可 让 Grid 控件 显示 单元 格 之 间 的 分 界线 。 


也 可 通过 在 设计 视图 中 单 击 网 格 的 边缘 来 定义 行 和 列 。 当 鼠标 指针 移 到 网 格 边 缘 时 ， 设 计 视 图 上 会 出 现 一 
条 横 穿 的 黄 线 ; 如 果 单 击 这 条 边 ， 就 可 以 插入 所 需 的 XAML 代码 。 这 样 操作 后 ， 行 和 列 的 Width 和 Height Æ 
性 会 由 设计 器 自动 设 定 ， 但 我 们 可 以 删除 这 两 个 属性 ， 或 者 拖 提 相应 的 线条 ， 以 满足 我 们 的 需要 。 


可 通过 Width. Height. MinWidth, MaxWidth. MinHeight 和 MaxHeight 属性 来 重新 调整 大 小 。 例 如 ， 为 
某 一 列 设置 Width 属性 可 以 使 其 保持 在 该 宽度 。 也 可 将 列 的 Width 属性 设置 为 *， 这 表示 “在 计算 其 他 所 有 列 的 
宽度 后 ， 占 满 剩 余 的 空间 。” 这 个 值 实际 上 就 是 默认 值 。 如 果 有 多 列 的 Width 为 *， 这 些 列 会 均 分 可 用 的 剩余 空 
间 。 行 的 Height 属性 也 可 以 使 用 * 这 个 值 。Height 和 Width 还 可 以 取 值 为 Auto， 也 就 是 根据 行 和 列 中 的 内 容 来 
HARE A A EA EE. 还 可 以 使 用 GridSplitter 控件 让 用 户 可 以 通过 鼠标 单 击 并 拖 电 的 方式 上 自行 调整 行 和 列 的 
大 小 。 

Grid 控件 的 子 控件 可 使 用 Grid.Column 和 Grid.Row 附加 属性 来 指定 自己 属于 哪个 单元 格 。 这 两 个 属性 的 默 
认 值 都 是 0， 也 束 是 说 ， 如 果 不 填 写 该 属性 ， 子 控件 会 默认 位 于 左上 角 的 单元 格 中 。 子 控件 还 可 以 使 用 
Grid.ColumnSpan 和 Grid-RowSpan 属性 来 使 目 己 横 跨 表 格 中 的 多 个 单元 格 ， 其 左上 角 的 单元 格 由 Grid.Column 
和 Grid.Row 属性 指定 。 

下 面 的 示例 中 使 用 Grid 的 属性 创建 了 一 些 行 和 列 ， 并 使 用 GridSplitter 在 运行 时 对 这 些 属性 进行 了 更 新 。 


试 一 试 ”使 用 行 和 列 : Ch14Ex01\MainWindow.xaml 


现在 回头 看 看 本 章 开头 介绍 的 包含 两 个 按钮 的 那个 示例 ， 然 后 执行 以 下 步骤 ; 
(1) 在 XAML 视图 中 单 击 选中 Grid 控件 。 
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(2) 在 设计 视图 中 将 鼠标 指针 移动 到 网 格 项 部 :将 会 看 到 一 条 橙色 的 线条 员 罕 整个 网 格 。 留 下 一 个 按钮 的 
空间 ， 然 后 单 击 该 线条 ， 生 成 两 列 。 

(3) 在 窗口 左 侧 重复 步骤 (2)， 生 成 两 行 。 

(4) 选择 两 个 按钮 中 的 第 一 个 。 注 意 ， 添 加 行 和 列 的 操作 实际 上 已 经 自动 为 该 按钮 添加 了 Grid Row 和 
Grid.Column 属性 。 将 这 两 个 附加 属性 的 值 设 置 为 0。 

(5) 对 Margin 属性 进行 必要 的 调整 ， 让 按钮 在 单元 格 中 完全 可 见 。 

(6) 第 二 个 按钮 也 已 改变 ， 例 如 添加 了 Margin 值 。 现 在 ， 将 第 二 个 按钮 的 Margin 属性 删除 掉 。 

(7) 在 XAML 视图 中 添加 一 个 GridSplitter 控件 ， 将 其 放 在 Grid 控件 结束 标签 的 上 一 行 ， 并 按照 如 下 方式 
设置 其 属性 : 


«GridSplitter Grid.RowSpan="2" Width="3" BorderThickness-"2" BorderBrush-"Black" /> 


(8) 运行 该 应 用 程序 。 完 整 的 XAML 代码 如 下 所 示 : 


«Window x:Class-"Chl4Ex01.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:Chl4Ex01" 
mc:lIgnorable-"d" 

Title-"MainWindow" Height-"350" width-"525" KeyDown-"Window KeyDown" 
PreviewKeyDown-"Window PreviewKeyDown"- 
«Grid KeyDown-"Grid KeyDown" PreviewKeyDown-"Grid PreviewKeyDown"> 
<Grid.RowDefinitions> 
<RowDefinition Height="109*"/> 
<RowDefinition Height="210*"/> 
</Grid.RowDefinitions> 
<Grid.ColumnDefinitions> 
<ColumnDefinition Width="191*"/> 
<ColumnDefinition Width="326*"/> 
</Grid.ColumnDefinitions> 
«Button x:Name-"button" Content-"Button" HorizontalAlignment="Left" 
Margin-"27,4,0,0" VerticalAlignment-"Top" Width-"75" Grid.Column="0" 
Grid.Row="0"/> 
«Button x:Name-"rotatedButton" Content="2nd Button" Width="75" Height="22" 
FontWeight-"Bold" RenderTransformOrigin-"0.5,0.5" 
KeyDown="rotatedButton KeyDown" 
PreviewKeyDown-"rotatedButton PreviewKeyDown" Grid.Column="1" 
Grid.Row="1" > 
<Button.RenderTransform> 
<TransformGroup> 
<ScaleTransform/> 
«SkewTransform/- 
«RotateTransform Angle-"-23.896"/-» 
<TranslateTransform/> 
</TransformGroup> 
</Button.RenderTransform> 
</Button> 
<Gridsplitter Grid.RowSpan="2" Width="3" BorderThickness="2" 
BorderBrush-"Black" /> 
</Grid> 
«/Window- 


如 图 14-8 所 示 ， 在 应 用 程序 运行 时 ， 分 隅 栏 被 拉 到 不 同位 置 上 。 
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8 MainWindow 


| Button 


图 14-8 


示例 说 明 

通过 将 网 格 控件 分 隅 为 两 列 和 两 行 ， 我 们 对 子 控件 在 网 格 中 的 定位 方式 进行 了 修改 。 将 第 一 个 按钮 的 
GridRow 和 Grid.Column 属性 设置 为 0 后 ， 束 将 其 从 原 位 置 移 到 左上 角 。 

第 二 个 按钮 看 起 来 并 没有 怎么 变化 ， 但 当 拖 电 GridSplitter 控件 的 分 隔 线 时 ， 可 以 看 到 该 按钮 的 边 距 现在 是 
相对 于 所 在 列 的 左边 缘 而 言 的， 也 就 是 说 在 窗口 中 左右 移动 分 隔 线 时 ， 按 钮 也 会 随 之 在 窗口 中 左右 移动 。 


14.4 游戏 客户 端 


现在 ,我 们 已 经 了 解 了 WPF 和 Visual Studio 的 基本 使 用 方法 ， 接 下 来 束 使 用 控件 创建 实际 应 用 。 本 划 剩 余 
部 分 和 第 15 章 将 主要 介绍 如 何 为 之 前 章节 中 所 开发 的 纸牌 游戏 编写 一 个 游戏 客户 闹 。 将 用 到 很 多 控件 来 编写 
这 个 游戏 客 己 并， 随后， 你 也 可 以 完全 上 日 己 编写 一 个 。 

本 章 将 为 这 个 游戏 写 一 些 支 持 性 的 对 话 框 一 一 包括 About. Options 和 New Game 窗口 。 


14.4.1 About 窗口 


About 窗口 有 时 称 为 About 对 话 框 ， 用 于 显示 开发 人 员 及 应 用 程序 本 号 的 一 些 信息 。 菏 些 About 窗口 十 分 
复杂 ， 例 如 Microsoft Office 和 Visual Studio 中 的 About 窗口 还 显示 了 版 本 和 许可 信息 。 在 应 用 程序 中 ，Help 3€ 
单 的 最 后 一 个 来 单项 通 单 用 来 打开 About 窗口 。 

接 下 来 要 创建 的 这 个 对 话 框 如 图 14-9 所 示 。 


8 ' About 


wrox Programmer to Programmer™ Karh Cards 
Karli Cards (c) Copyright 2017 by Wrox Press and all readers 


CardLib and Idea developed by Karli Watson 
Graphical User Interface developed by Jacob Hammer 


Karli Cards developed with C# 7 for Wrox Press. You can visit Wrox Press 
at http://www.wrox.com. 


图 14-9 
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1. 设计 用 户 界面 

用 户 并 不 会 频繁 使 用 About 窗口 。 实际 上 , 之 所 以 把 它 放 在 Help 菜单 中 ,是 因为 只 有 当 用 户 需 要 查看 应 用 
程序 版 本 信息 ， 或 者 当 应 用 程序 出 问题 后 需要 寻找 联系 方式 的 时 候 才 会 访问 它 。 但 这 也 意味 着 它 对 用 户 是 有 用 
的 ， 所 以 既然 要 在 应 用 程序 中 设计 这 个 窗口 ， 就 需要 重视 它 。 

设计 一 个 应 用 程序 时 ， 应 当 尽量 保持 外 观 和 风格 的 一 致 性 。 也 就 是 说 ， 应 当 在 整个 应 用 程序 中 使 用 几 种 固 
定 的 颜色 ,并 在 不 同位 置 使 用 相同 的 控件 样式 。 在 Karli Cards 这 个 游戏 中 , 我 们 将 主要 使 用 三 种 颜色 _ 红色、 
黑色 和 白色 。 

如 果 观 察 图 14-9， 会 发 现 该 窗口 左上 角 是 Wrox 出 版 社 的 徽标 。 之 前 还 没有 使 用 过 图 像 ， 但 在 应 用 程序 中 
添加 一 些 特定 的 图 像 可 以 让 用 户 界面 看 起 来 更 专业 。 


2. Image 控件 


Image 是 一 个 简单 却 效果 非凡 的 控件 。 它 可 以 显示 一 幅 图 片 ， 并 按照 需要 对 其 进行 适当 的 大 小 调整 。 该 控件 
公开 了 两 个 属性 ， 如 表 14-3 所 示 。 


表 14-3 Image 控件 的 属性 

gm 性 说 明 
该 属性 用 于 指定 图 像 位 置 。 既 可 以 是 磁盘 上 的 某 个 位 置 ， 也 可 以 是 Web 上 的 某 个 位 置 。 如 第 15 章 所 述 ， 也 可 
以 创建 一 个 静态 资源 ， 并 将 其 作为 图 像 源 使 用 
实际 上 ， 图 片 大 小 很 少 正 好 符合 我 们 的 需要 ， 并且 很 多 时 候 图 片 的 大 小 还 需要 随 着 应 用 程序 窗口 的 改变 而 改变 。 
可 使 用 该 属性 来 控制 图 像 如 何 进行 大 小 调整 。 可 用 值 包括 ; 
None 一 一 永远 不 会 调整 图 像 大 小 。 

Stretch Fill 一 一 拉 伸 图 片 ， 使 其 充满 整个 可 用 区 域 。 这 可 能 改变 图 片 的 比例 。 

Uniform 一 一 保持 图 片 的 宽 高 比 ， 如 果 改 变 了 宽 高 比 ， 不 会 充满 所 有 可 用 区 域 。 
UniformToFil 一 一 在 保持 宽 高 比 的 同时 充满 整个 可 用 区 域 。 如 果 在 保持 宽 高 比 的 情况 下 图 片 大 于 可 用 区 域 ， 就 
会 裁减 反超 出 范围 的 区 域 ， 以 适应 可 用 区 域 的 大 小 


Source 


3. Label 控件 

在 之 前 的 一 些 示 例 中 ， 已 经 见 过 此 类 最 简单 的 控件 了 。 它 向 用 户 显示 简单 的 文本 信息 ， 革 些 情况 下 还 显示 
相关 的 快捷 键 。 它 使 用 Content 属性 来 显示 文本 信息 ,使 用 Label 控件 显示 单行 文字 。 如 果 在 某 个 字母 前 添加 下 
mék“ ”前 级 ， 那 么 该 字母 在 控件 中 显示 时 会 带 有 下 夯 线 ， 并 且 通 过 Alt 与 该 字母 的 组 合 就 可 以 直接 访问 该 控 
件 。 例 如 ， Name 可 以 为 这 个 Label 所 在 的 控件 直接 指定 AltHN 快捷 键 。 

4. TextBlock 控件 

与 Label 控件 类 似 , 该 控件 也 用 于 显示 不 售 任 何 复杂 格式 信息 的 简单 文本 。 [HE Label 不 同 的 是 ，TextBlock 
控件 可 以 显示 多 行文 本 。 不 能 对 其 组 成 文本 单独 设置 格式 。 

TextBlock 直接 显示 文本 内 容 ， 即 使 所 在 控件 没有 足够 的 空间 来 显示 文本 内 容 也 是 这 样 。 当 内 容 过 多 时 ， 访 
控件 并 不 会 显示 深 动 条 ， 但 可 在 需要 时 将 其 放 在 一 个 简单 的 视图 控件 ScrollViewer 中 ， 来 解决 这 一 问题 。 

5. Button 控件 

HE Label 控件 一 样 ， 之 前 也 介绍 过 Button 控件 。 它 可 用 在 用 户 界 面 的 任何 地 方 ， 而 且 易 于 识别 。 用 户 可 以 
单 击 这 个 控件 来 完成 某 种 操作 一 一 但 也 仅 如 此 而 已 。 如 果 试 图 改变 其 功能 ， 人 往往 导致 糟 糙 的 界面 设计 ， 让 用 户 
感到 困惑 不 解 。 

默认 情况 下 ，Button 上 可 显示 一 行 简短 文本 或 一 幅 图 片 ， 来 介绍 单 击 该 控件 之 后 所 执行 的 操作 。 

Button 控件 并 不 包含 任何 用 于 显示 图 片 或 文本 的 属性 ,但 可 使 用 Content 属性 来 显示 简单 文本 ,或 在 Content 


310 | 第 中 部 分 Windows 编程 


中 散 入 一 个 Image 控件 来 显示 图 片 。 相 关 代 码 可 在 Ch14Ex01\ImageButton.xaml 下 载 文 件 中 找到 : 


«Button HorizontalAlignment="Left" VerticalAlignment-"Top" Width-"75" Margin="10" > 
<StackPanel Orientation="Horizontal"> 
«Image Source=".\Images\Delete black 32x32.png" Stretch-"UniformToFill" 
Width="16" Height-"16" /> i i 
<TextBlock>Delete</TextBlock> 


</StackPanel> 
</Button> 
=e 
注意 : 


上 述 按钮 中 用 到 的 图 片 位 于 下 载 代码 的 Ch14Ex01\Images 文件 夹 中 ， 


图 14-10 展示 了 一 个 同时 包含 文本 和 图 像 的 Delete 按钮 。 
图 14-10 
NAE: 


要 完成 下 面 这 个 示例 ,需要 一 个 用 作 横 幅 的 图 像 文 件 .该 文件 所 在 位 置 为 KarliCards.Gui\Images\Banner.pneg。 


试 一 试 ” 创 建 About BHO: KarliCards.Gui\AboutWindow.xaml 


在 开始 创建 About 窗口 前 ， 需 要 新 建 一 个 项 目 。 除 本 窗口 外 ， 本 章 和 下 一 章 还 会 创建 好 几 个 窗口 ， 因 
此 ， 请 新 建 一 个 WPF App(CNET Framework) 项 目 ， 并 将 其 命名 为 KarliCards.Gui。 将 相应 的 解决 方案 命名 为 
KarliCards. 

(1) 在 Solution Explorer 中 右 击 KarliCards.Gui 项 目 ， 然 后 选择 Add | Window， 并 将 该 窗口 命名 为 
AboutWindow.xaml. 

(2) (HW RIP, Boni Be PEN SOKUS Bi): 


Height="300" Width="434" MinWidth="434" MinHeight="300" 
ResizeMode-"CanResizeWithGrip" 


(3) 选择 Grid 控件 ， 然 后 单 击 网 格 边 绿 创建 4 行 。 不 必 考 虑 每 一 行 的 准确 位 置 ， 只 需要 将 它们 的 值 改 为 如 
下 所 示 即 可 : 


<Grid.RowDefinitions> 
<RowDefinition Height="58"/> 
<RowDefinition Height="20"/> 
<RowDefinition /> 
<RowDefinition Height="42"/> 

</Grid.RowDefinitions> 


(4) 将 工具 箱 中 的 Canvas (FH Ble E11. MiA Visual Studio 插入 的 所 有 属性 ， 然 后 添加 以 下 
代码 : 

Grid.Row="0" Background="#C40D42" 

(5) 选中 新 建 的 Canvas 控件 ， 将 一 个 Image 控件 拖 忠 到 其 中 。 修 改 其 属性 ， 如 下 所 示 : 


Height-"56" Canvas.Left="0" Canvas.Top-"0" Stretch-"uniformToFill" 
Source=".\Images\Banner.png” 


(6) 右 击 该 项 目 ， 然 后 选择 Add | New Folder。 将 新 建 的 这 个 文件 夹 命 名 为 Images。 

(7) 在 Solution Explorer 中 右 击 新 建 的 文件 夹 ， 选 择 Add | Existing Item。 浏 览 本 章 用 到 的 图 片 。 选 中 所 有 
这 些 图 片 ， 然 后 单 击 Add。 这 样 ， 横 幅 就 会 显示 在 设计 视图 中 。 

(8) 选中 Canvas 控件 ， 并 将 一 个 Label 控件 拖 电 到 其 中 。 修 改 其 属性 ， 如 下 所 示 : 


Canvas.Right-"10" Canvas.Top-"25" Content-"Karli Cards" Foreground-"4FFF7EFEF" 
FontFamily-"Times New Roman" 


(9) 选中 Grid 控件 ， 并 将 一 个 新 的 Canvas 控件 拖 电 到 其 中 。 将 其 属性 修改 为 : 
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Grid.Row="1" Background-"Black" 


(10) 选中 新 建 的 Canvas 控件 ， 并 将 一 个 Label 控件 拖 电 到 其 中 。 将 其 属性 修改 为 ; 
Canvas.Left="5" Canvas.Top="0" FontWeight="Bold" FontFamily="Arial" 
Foreground-"White" 

Content-"Karli Cards (c) Copyright 2012 by Wrox Press and all readers" 

(11) 再 次 选中 Grid 控件 ， 将 最 后 一 个 Canvas 控件 拖 电 到 最 下 的 一 行 中 。 将 其 属性 修改 为 ; 
Grid.Row-"3" 

(12) 选中 新 建 的 Canvas 控件 ， 将 一 个 Button 控件 拖 电 到 其 中 。 将 其 属性 修改 为 : 
Content-" OK" Canvas.Right-"12" Canvas.Bottom-"10" Width="75" 

(13) 再 次 选中 Grid 控件 ， 将 一 个 StackPanel 控件 拖 电 到 最 后 一 个 居中 的 行 上 。 将 其 属性 修改 为 : 
Grid.Row="2" 

(14) 选中 该 StackPanel 控件 ， 依 次 将 两 个 Label 控件 和 一 个 TextBlock 控件 拖 电 到 其 中 。 
(15) 用 如 下 代码 修改 最 上 方 的 Label 控件 : 

Content="CardLib and Idea developed by Karli Watson" HorizontalAlignment="Left" 
VerticalAlignment="Top" Padding="20,20,0,0" FontWeight="Bold" 
Foreground-"£FF8B6F6F" 

(16) 修改 接 下 来 的 Label 控件 ， 如 下 所 示 : 

Content="Graphical User Interface developed by Jacob Hammer" 


HorizontalAlignment-"Left" Padding-"20, 0,0,0" VerticalAlignment-"Top" 
FontWeight-"Bold" Foreground-"$FFS8B6F6F" 


(17) 修改 TextBlock, Wn F Rim: 

Text="Karli Cards developed with C# 7 for Wrox Press. 

You can visit Wrox Press at http://www.wrox.com." 

Margin-"0, 10,0,0" Padding-"20,0,0,0" TextWrapping-"Wrap" 
HorizontalAlignment-"Left" VerticalAlignment-"Top" Height-"39" 


(18) 双击 该 按钮 ， 在 事件 处 理 程 序 中 添加 如 下 代码 : 
private void Button Click(object sender, RoutedEventArgs e) 


this.Close(t); 
] 


(19) f£ Solution Explorer 中 双击 App.xaml 文件 ,将 StartupUri 属性 由 MainWindow.xaml 改 为 AboutWindow. 
xaml. 
(20) 运行 该 应 用 程序 。 


示例 说 明 

开始 时 在 该 窗口 中 设置 了 一 些 属性 。 通 过 设置 MinWidth 和 MinHeight 属性 ， 可 以 防止 用 户 将 窗口 大 小 调 
整 到 遮挡 住 内 容 的 程度 。ResizeMode 属性 被 设置 为 CanResizeWithGrip， 这 可 以 让 窗口 的 右 下 角 出 现 一 个 小 手 
柄 标志 ， 让 用 户 知道 该 窗口 的 大 小 是 可 以 调整 的 。 

接 下 来 为 网 格 添加 4 行 。 为 此 ， 定 义 窗口 的 基本 结构 。 将 第 1、2 和 4 行 设置 为 固定 高 度 ， 确 保 只 有 第 3 
行 的 高 度 是 可 变 的 ， 这 是 包含 内 容 的 那 一 行 。 

随后 添加 了 第 一 个 Canvas 控件 。 该 控件 可 以 轻松 地 设置 第 一 行 的 背景 色 。 通 过 确保 该 Canvas 大 小 可 变 ， 
强制 使 它 充 满 网 格 的 第 一 行 。 

添加 到 Canvas 中 的 Image 控件 被 固定 在 Canvas 的 左上 角 ， 这 样 可 以 确保 窗口 大 小 改变 时 ， 图 像 保 持 不 
变 , 随 后 将 图 片 的 高 度 设置 为 固定 值 , 而 宽度 保持 自由 。 由 于 将 Stretch 属性 设置 为 UniformToFil, 因此 Image 
控件 会 将 高 度 作 为 宽 高 比 的 标准 ， 它 可 以 目 动 调整 目 己 的 宽度 来 匹配 已 经 设 定好 的 高 度 和 宽 高 比 。 

第 一 行 的 最 后 一 个 部 分 添加 了 一 个 Label 控件 ,将 其 固定 到 Canvas 的 右上 角 , 以 确保 调整 窗口 大 小 时 ,Label 
会 随 着 右边 缘 移动 。 

接 下 来 开始 处 理 第 二 行 ， 其 中 包含 另 一 个 Canvas 控件 ， 该 控件 中 又 包含 一 个 Label 控件 。 
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JAB Canvas 与 此 类似 ， 所 不 同 的 是 在 其 中 添加 的 是 一 个 Button 控件 ， 并 将 其 固定 到 Canvas 的 右 下 角 。 
这 样 可 确保 窗口 大 小 改变 时 ,该 按钮 始终 位 于 窗口 的 右 下 角 。OK 文本 前 加 下 夯 线 “” 即 可 为 该 按钮 创建 Alt+O 

最 后 在 第 三 行 中 添加 了 一 个 StackPanel, HEE PAIN Label 和 TextBlock 控件 。 通 过 将 第 一 个 Label 的 
Padding 值 设置 为 20.20.0.0， 让 该 控件 的 内 容 距 离 上 边缘 和 左边 缘 各 20 像素 。 

下 一 个 Label 的 Padding 值 为 20,0,0,0， 只 留 出 了 左边 的 空白 ， 这 是 因为 两 个 Label 之 间 的 空间 正好 合适 ， 
并 不 需要 多 余 的 空白 。 

最 后 对 TextBlock 进行 了 设置 .将 属性 TextWrapping 设置 为 Wrap. 以 便 文本 在 一 行 中 容纳 不 下 时 目 动 换行 。 
在 窗口 大 小 变化 , 一 行 变 得 更 长 后 , 文本 又 可 以 目 动 排列 为 较 少 行 。 这 里 也 用 到 Margin 和 Padding 属性 Margin 
设置 为 距离 上 方 的 Label 控件 10 像素 ，Padding 则 将 其 内 容 设 置 为 距离 控件 左边 20 像素 。 

最 后 ， 事 件 处 理 程 序 中 的 代码 关闭 窗口 。 在 本 例 中 ， 这 相当 于 关闭 整个 应 用 程序 ， 因 为 在 第 (19) 步 中 将 局 
动 窗口 设置 为 About 窗口 ， 因 此 关闭 它 束 会 目 动 关闭 应 用 程序 。 


14.4.2 Options 窗口 


接 下 来 将 创建 Options 窗口 。 该 窗口 让 玩家 可 设置 一 些 可 以 改变 游戏 玩法 的 参数 。 其 中 也 会 用 到 一 些 之 前 
未 涉及 的 控件 ， 包 括 CheckBox、RadioButton、ComboBox、TextBox 和 TabControl. 

图 14-11 显示 Options 窗口 中 选中 第 一 个 选项 卡 时 的 情景 。 乍 看 起 来 ， 这 个 窗口 和 About 窗口 很 像 , 但 是 我 
们 在 其 中 可 以 获得 更 多 功能 。 


8 ' Options 


Ld 
wrox Programmer to Programmer™ Options 


Game | Computer Player 


| | Play against computer 


Number of players 


| | Cancel 


1. TextBox 控件 


Z3 HU ff] FA Label 和 TextBlock HEF. ixp9g^ T2 FI E Hd e In] AP ea ATI. m TextBox 控件 则 多 
WHFP IAI Ei AEE RJR Ee n] DS AS, (BRAIN BBE SAN SCA rf fs HH 
它 ， 除 非 在 此 基础 上 还 允许 用 尸 编辑 显示 的 文本 。 如 果 非 要 用 TextBox 来 仅 显 示 文 本 ， 需 要 将 IsEnabled 属性 设 
置 为 false， 以 防 用 户 编 辑 其 中 的 内 容 。 

使 用 表 14-4 中 所 示 的 一 系列 属性 ， 可 以 控制 在 TextBox 中 输入 和 显示 文本 的 方式 。 


表 14-4 TextBox 控件 的 属性 


» 性 "EN" 
Text TextBox 控件 中 当前 显示 的 文本 
IsEnabled 将 该 属性 设置 为 true 时 ， 用 户 可 以 编辑 TextBox PRIMA. WRA false, MASERAKE, AP 
5 Ic 


无 法 将 键盘 焦点 放 到 该 控件 上 
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(ER) 

属 性 说 BB 

有 时 我 们 希望 TextBox 只 显示 一 行文 本 。 这 种 情况 下 ， 可 以 将 该 属性 值 设置 为 NoWrap. iX 

默认 值 。 如 果 和 希望 将 文本 显示 为 多 行 ， 可 将 其 值 设 置 为 Wrap 或 WrapWithOverflow. Wrap 表示 超 

出 文本 框 边缘 的 文本 内 容 会 被 移 到 下 一 行 中 。WrapWithOverflow 则 表示 如 果 文 本 中 没有 合适 的 换 

行 位 置 ， 允 许 非 常 长 的 单个 单词 超出 文本 框 的 边缘 

GRICE ATE TextBox 中 输入 多 行文 本 ， 那 么 用 户 输入 的 内 容 有 可 能 会 超出 文本 框 的 下 边界 ， 从 

而 无 法 完整 显示 。 这 种 情况 下 ， 有 必要 使 用 滚动 条 进行 操作 。 如 果 和 希望 仅 当 文本 过 长 时 目 动 显示 滚 

动 条 ， 可 将 此 属性 设置 为 Auto。 设 置 为 Visible 表示 始终 显示 滚动 条 ， 设 置 为 Hidden 或 Disabled 则 

表示 无 论 什 么 情况 下 都 不 显示 滚动 条 

此 属性 用 于 控制 在 TextBox 控件 中 输入 文本 的 方式 。 如 果 将 其 设置 为 默认 值 false， 用 户 就 不 能 通过 

回 车 键 换行 


TextWrapping 


VerticalScrollBar Visibility 


AcceptsRetum 


2. CheckBox 控件 


CheckBox 15:4 F FHF In] Hd JP? an up Ee Pa ER aC. ELA 5 8 IR] SAN PPL, 或 布 望 用 户 
答 一 个 关于 是 或 否 的 问题 ， 可 以 使 用 CheckBox 控件 。 例 如 ， 在 Options 对 话 框 中 ,我们 希望 用 户 选择 是 否 要 与 
电脑 进行 对 战 游戏 。 为 此 使 用 CheckBox 控件 ， 并 在 劳 边 标明 文本 “Play Against Computer” . 

按照 设计 ，CheckBox 是 独立 实体 ， 不 会 受到 视图 中 其 他 CheckBox 控件 的 影响 。 有 时 ， 我 们 会 发 现 多 个 
CheckBox 有 某 种 链接 关系 ， 选 中 其 中 一 个 后 ， 其 余 的 会 被 设置 为 未 选中 状态 ， 但 实际 上 这 并 不 是 CheckBox 控 
件 应 有 的 用 途 。 要 实现 这 种 功能 ， 应 该 使 用 下 一 节 介绍 的 RadioButton 控件 。 

CheckBox 也 可 以 显示 第 三 种 状态 , 即 “ 不 确定 ”状态 , 表示 不 能 回答 “是 ”或 “ 否 ”这 个 问题 。 当 CheckBox 
用 于 显示 其 他 项 的 信息 时 ， 经常 使 用 这 种 状态 。 例 如 ，CheckBox 有 时 用 于 表示 在 一 个 树 型 视图 中 ， 是 否 所 有 子 
节 扩 都 已 经 被 选中 。 这 种 情况 下 ， 如 果 所 有 节 扣 都 被 选中 ， 则 CheckBox 是 选中 状态 ; WRT AT AAP, 
则 CheckBox 为 未 选中 状态 ， 如 果 只 选中 了 其 中 一 部 分 节点 ， 则 CheckBox 会 是 不 确定 状态 。 

d 14-5 列 出 了 CheckBox 控件 常用 的 属性 。 


表 14-5 CheckBox 控件 的 属性 
m 性 说 明 
CheckBox 是 一 种 内 容 控 件 ， 其 中 显示 的 内 容 是 可 以 完全 自 定义 的 。 在 Content 属性 中 添加 一 些 文本 会 显示 默 
认 视 图 
IsThreeState 此 属性 用 于 指定 该 控件 有 两 种 状态 还 是 三 种 状态 。 默 认 值 为 多 lse， 表 示 该 控件 只 有 两 种 状态 
此 属性 的 值 可 以 是 true 或 false。 默 认 情 况 下 ， 将 其 设置 为 tue 会 显示 为 选中 状态 。 如 果 IsThreeState 为 true, 
该 属性 还 可 以 取 值 为 null， 表 示 该 控件 的 状态 为 不 确定 


Content 


IsChecked 


3. RadioButton 控件 


RadioButton 总 与 其 他 RadioButton 控件 结合 使 用 ， 让 用 户 可 在 多 个 选项 中 进行 选择 ， 并 且 某 一 时 间 只 能 
择 一 个 选项 。 如 果 和 希望 用 户 回答 一 些 只 有 少数 几 种 可 选 答 案 的 问题 ， 就 可 以 使 用 RadioButton 控件 。 而 如 果 可 
能 的 答案 多 于 4 个 ， 就 需要 考虑 改 用 ListBox 或 ComboBox 控件 。 在 稍 后 创建 的 Options 窗口 中 , 用 户 可 以 选择 
电脑 玩家 的 技能 水 平 。 我 们 设计 了 三 种 选项 : Dumb( 简 单 )、Good( 中 等 ) 和 Cheats( 很 难 )。 当 然 ， 同 一 时 刻 只 能 
选择 一 项 。 

如 果 在 同一 视图 中 要 用 到 多 个 RadioButton 控件 ， 它 们 之 间 会 默认 建立 一 种 关联 ， 在 其 中 一 个 被 选中 时 ， 
所 有 其 余 RadioButton 控件 都 变 为 未 选中 状态 。 如 果 一 个 视图 中 的 多 个 RadioButton 控件 不 需要 建立 起 这 种 关 
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联 ， 可 将 它们 分 到 不 同 的 组 中 ， 以 免 其 他 控件 将 这 些 没 有 关联 的 控件 的 值 清除 。 
可 使 用 表 14-6 中 所 示 的 属性 来 控制 RadioButton. 


表 14-6 RadioButton 控件 的 属性 
m 性 说 明 
Content RadioButton 是 内 容 控 件 ， 因 此 可 以 修改 其 显示 的 内 容 。 默 认 情 况 下 ， 在 Content 中 输入 文本 
IsChecked 值 可 以 是 true BX false. WSR IsThreeState 被 设置 为 tue， 还 可 以 取 值 为 null， 表 示 状 态 不 确定 
GroupName 表示 相应 控件 属于 哪 一 组 。 默 认 情 况 下 该 属性 的 值 为 空 ， 而 GroupName 值 为 空 的 所 有 RadioButton 控件 都 被 认 
为 属于 同一 组 


4. ComboBox 控件 


5j RadioButton 和 CheckBox 控件 一 样 ，ComboBox 允许 用 户 选择 一 个 选项 。 不 过 ，ComboBox 与 其 存在 两 
方面 的 根本 性 区 别 : 

e ComboBox 在 一 个 下 拉 列 表 中 显示 可 选项 。 

e ComboBox 人 允许 用 户 目 行 输入 新 值 。 

ComboBox 常用 于 显示 一 个 包含 许多 值 的 列表 ， 例 如 国家 、 地 区 或 省 的 列表 ， 但 它们 也 可 用 于 其 他 许多 用 
途 。 在 Options 对 话 框 中 ，ComboBox 用 于 让 用 户 选 择 玩 家 数量 。 尽 官 通过 RadioButton 也 可 以 完成 这 个 功能 ， 
但 使 用 ComboBox 可 以 节省 视图 空间 。 

ComboBox 可 以 改 为 在 其 项 部 显示 一 个 Textbox， 以 便 允 许 用 尸 输入 一 些 未 能 包含 在 列表 中 的 值 。 本 章 中 
的 一 个 练习 要 求 在 Options 对 话 框 中 添加 一 个 ComboBox 控件 ， 让 用 户 既 可 以 输入 自己 的 名 称 ， 又 可 以 从 列表 
中 选择 一 个 现 有 的 名 称 。 

该 控件 的 IsReadOnly 和 IsEditable 属性 对 于 控件 行为 非常 重要 ， 将 这 两 个 属性 结合 起 来 使 用 ， 可 以 让 用 户 
通过 4 种 不 同方 式 使 用 键盘 来 选择 ComboBox 的 值 ( 见 表 14-7). 


表 14-7 IsReadOnly 和 1IsEditable 属性 的 组 合 


IsReadOnly W true IsReadOnly 为 false 


TextBox 正常 显示 , 但 控件 本 号 对 按键 操 | TextBox 正常 显示 ， 用 户 也 可 以 正常 进行 输入 。 如 果 用 户 输入 


IsEditable 为 tue | 作 不 会 有 任何 反应 .如果 在 列表 中 选择 某 | 的 内 容 己 经 在 列表 中 ， 就 会 选中 这 部 分 内 容 。 在 用 户 输 入 内 容 
一 项 ， 可 在 TextBox 中 选择 文本 的 过 程 中 ， 控 件 将 显示 该 内 容 在 列表 中 的 最 佳 匹 配 项 
. 如 果 IsEditable 871873 false, MA IsReadOnly 的 值 不 会 有 任何 影响 ， 因 为 不 会 显示 文本 框 。 选 中 该 控件 后 ， 
IsEditable 7j false 


Hi? np AJ REPE eS, ED ANA eA TE B TR 


ComboBox 是 项 控件 ， 也 就 是 说 ,我 们 可 在 其 中 添加 许多 项 内 容 。 表 14-8 列举 了 ComboBox 控件 中 的 其 他 
一 些 属性 。 


表 14-8 ComboBox 控件 的 其 他 属性 


属 性 说 有明 
Text Text 属性 表示 要 在 ComboBox 顶端 显示 的 文本 内 容 。 可 以 是 列表 中 的 某 一 项 ， 也 可 以 是 用 户 输入 的 新 文本 
| 表示 选中 的 项 在 列表 中 的 索引 值 。 如 果 等 于 -1， 代 表 没 有 进行 任何 选择 ， 或 者 用 户 输 入 的 内 容 不 是 列表 中 的 
SelectedIndex 其 一 项 


表示 列表 中 实际 的 某 一 项 ， 而 不 仅 是 索引 值 或 文本 内 容 。 如 果 没 有 选择 任何 一 项 或 者 用 户 输入 了 新 内 容 ， 返 
null 


SelectedItem 
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5. TabControl 控件 


TabControl 与 本 节 中 介绍 的 所 有 控件 存在 本 质 差 异 。 它 是 一 个 布局 控件 ， 用 于 对 页 面 上 可 以 通过 单 击 来 选 
择 的 内 容 进 行 分 组 。 

当 和 希望 在 一 个 窗口 中 显示 许多 内 容 ， 又 不 布 望 让 视图 变 得 六 杂乱 时 ， 可 以 使 用 TabControl。 这 种 情况 下 ， 
应 该 将 不 同 的 信息 按照 相关 性 分 为 不 同 的 组 ， 并 为 每 一 组 建 一 个 页 面 。 一 般 来 说 ， 不 应 当 让 有 茶 一 页 中 的 控件 影 
啊 其 他 页 面 中 的 控件 。 如 果 它 们 互相 影响 ， 用 户 将 不 知道 为 一 页 中 的 选项 已 经 被 改变 ， 寻 致 他 们 产生 困惑 。 

默认 情况 下 ,每 个 页 面部 由 TabItem 组 成 ，TabItem MERU — Grid 控件 。 不 过 ， 可 以 根据 需要 把 Grid 
蔡 换 为 任何 其 他 控件 。 在 每 个 选项 卡 中 都 可 以 放置 一 些 UL 元 素 ， 并 通过 选择 TabItem 来 切换 不 同 的 选项 卡 。 每 
个 TabItem 都 有 一 个 用 于 显示 选项 卡 名称 的 标题 (Header)。 该 标题 可 以 是 一 个 Content 控件 ， 也 就 是 说 ， 可 以 自 
定义 标题 的 显示 内 容 ， 而 不 只 是 使 用 单纯 的 文本 。 


试 一 试 ” 设 计 Options 窗口 : KarliCards.Gui\OptionsWindow.xam| 


第 一 眼看 到 Options 窗口 时 ， 也 许 会 发 现 ， 它 与 About 窗口 十 分 相似 ， 事 实 的 确 如 此 。 正 由 于 它们 很 像 ， 
所 以 我 们 可 以 重复 使 用 之 前 示例 中 用 到 的 一 些 代码 。 

(1) 在 Solution Explorer 中 右 击 项 目 ， 选 择 Add |Window。 将 窗口 命名 为 OptionsWindow.xaml. 

(2) 删除 默认 插入 的 Grid 控件 。 

(3) 打开 之 前 描述 过 的 AboutWindow.xaml 窗口 ， 将 Grid 控件 及 其 中 所 有 内 容 复 制 并 粘贴 到 新 的 
OptionsWindow. xaml 文件 中 。 

(4) 修改 窗口 属性 ， 如 下 所 示 : 

Title="Options" Height="345" Width="434" ResizeMode="NoResize" 

(5) 删除 StackPanel 及 其 所 有 内 容 。 

(6) 删除 Grid.Row 属性 值 为 3 的 Canvas 控件 及 其 所 有 内 容 。 

(7) 删除 Grid.Row 属性 值 为 1 的 Canvas 控件 中 的 Label 控件 。 

(8) 修改 Grid Row 属性 值 为 0 的 Canvas 控件 中 的 Label 控件 ， 如 下 所 示 : 


«Label Canvas.Right="10" Canvas.Top="13" Content-"Options" Foreground-"4FFF7EFEF" 
FontFamily-"Times New Roman" FontSize="24" FontWeight-"Bold" /> 


(9) 将 一 个 StackPanel 控件 拖 电 到 最 底部 的 行 ， 将 其 属性 设置 为 
Grid.Row-"3" Orientation-"Horizontal" FlowDirection-"RightToLeft" 
(10) 在 StackPanel 中 添加 两 个 按钮 ， 如 下 所 示 : 


«Button Content-" Cancel" Height-"22" Width="75" Margin="10,0,0,0" 
Name-"cancelButton" /> 

«Button Content-" OK" Height-"22" Width="75" Margin-"10,0,0,0" 
Name-"okButton" /> 


(11) 将 一 个 TabControl PHERI, FERJSTEUC ELA: 


Grid.RowSpan="2" Canvas.Left="10" Canvas.Top-"2" Width="408" Height-"208" 
Grid.Row="1" 


(12) 将 两 个 TabItem 控件 的 Header 属性 分 别 改 为 Game 和 Computer Player. 
现在 ， 该 窗口 的 外 观 应 该 如 图 14-12 所 示 ， 接 下 来 就 该 在 选项 卡 中 插入 一 些 内 容 了 。 
(13) 选择 Game TabItem， 然 后 将 一 个 CheckBox 拖 电 到 其 中 。 将 其 属性 设置 为 : 


Content="Play against computer" HorizontalAlignment="Left" Margin="11,33,0,0" 
VerticalAlignment-"Top" Name-"playAgainstComputerCheck" 
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LJ 
wrox Programmer to Programmer™ Options 


Game | Computer Player 
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图 14-12 


(14) 在 该 TabItem 中 拖 入 一 个 Label 控件 和 一 个 ComboBox 控件 ， 并 将 它们 的 属性 设置 为 : 
<Label Content="Number of players" HorizontalAlignment="Left" 
Margin-"10,54,0,0" VerticalAlignment-"Top" /> 
<ComboBox HorizontalAlignment-"Left" Margin-"196,58,0,0" 
VerticalAlignment-"Top" Width-"86" Name-"numberOfPlayersComboBox" 
SelectedIndex-"0" > 
«ComboBoxItem-2«/ComboBoxItem-» 
<ComboBoxItem>3< /ComboBoxItem> 
<ComboBoxItem>4</ComboBoxItem> 
< /ComboBox> 


(15) 选择 标题 为 Computer Player 的 第 二 个 TabItem. 将 一 个 Label 和 三 个 RadioButton 控件 拖 电 到 Grid 中 ， 
然后 将 它们 的 属性 设置 为 : 

<Label Content="Skill Level" HorizontalAlignment="Left" 
Margin="10,10,0,0" VerticalAlignment="Top"/> 

<RadioButton Content="Dumb" HorizontalAlignment="Left" 
Margin="37,41,0,0" VerticalAlignment-"Top" IsChecked-"True" 
Name="dumbAIRadioButton"/> 

<RadioButton Content="Good" HorizontalAlignment="Left" 
Margin="37,62,0,0" VerticalAlignment-"Top" Name="goodAIRadioButton"/> 

«RadioButton Content-"Cheats" HorizontalAlignment="Left" 
Margin-"37,83,0,0" VerticalAlignment-"Top" 
Name-"cheatingAIRadioButton"/» 


(16) 至 此 已 经 完成 了 该 窗口 的 布局 。 打 开 App.xaml X ff, T$ StartupUri 设置 为 OptionsWindow.xaml。 
(17) 运行 该 应 用 程序 。 


示例 说 明 

窗口 的 ResizeMode 设置 为 NoResize。 这 样 ， 我 们 在 放置 控件 时 就 不 必 考 虑 窗口 大 小 改变 时 会 友 生 什么 情 
况 了 ， 因 为 用 尸 无 法 下 调整 窗口 的 大 小 。 

第 (9) 步 中 的 StackPanel 引入 了 新 属性 FlowDirection， 其 值 为 RightToLeft。 这 样 ， 添 加 到 其 中 的 两 个 按钮 就 
会 徘 紧 对 话 框 的 右边 缘 ， 而 不 是 默认 的 左边 缘 了 。 有 趣 的 是 ， 这 样 的 修改 也 会 改变 两 个 按钮 的 Margin 属性 的 含 
义 ， 即 Left Right 的 含义 会 互 换 。 

第 二 个 选项 卡 中 的 RadioButton 并 未 指定 GroupName， 这 样 ， 它 们 就 会 作为 一 组 。 随 后 为 其 中 第 一 个 设置 
J IsChecked 属性 为 tue， 使 其 成 为 默认 的 选中 项 。 


6. 处 理 Options 窗口 中 的 事件 


现在 ，Options 窗口 看 起 来 已 经 不 错 了 ， 但 用 户 还 不 能 通过 它 实现 什么 功能 ， 即 使 更 改 其 中 的 设置 也 没有 任 
何 意义 。 用 户 希望 他 们 所 做 的 选择 可 以 保存 下 来 ， 并 且 被 应 用 程序 使 用 。 为 此 ， 可 将 控件 的 值 保存 在 这 个 窗口 
中 ， 但 是 这 样 做 之 后 会 非常 缺乏 灵活 性 ， 会 将 应 用 程序 数据 与 GUI 混在 一 起 ， 因 此 并 不 是 一 种 良好 的 设计 。 我 
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们 应 该 创建 一 个 类 ， 并 将 用 户 所 做 的 选择 保存 在 其 中 。 
下 面 的 示例 中 将 事件 处 理 程序 添加 到 Options 窗口 ， 在 用 户 与 控件 交互 时 会 执行 这 些 事件 处 理 程 序 。 


试 一 试 ”处 理事 件 : KarliCards.Gui\OptionsWindow.xaml 


本 例会 在 项 目 中 添加 一 个 新 类 ， 将 用 尸 所 做 的 选择 保存 在 其 中 ， 并 处 理 用 尸 改 变 选择 时 所 友 生 的 事件 。 
(1) 在 项 目 中 狐 建 一 个 类 ， 将 其 命名 为 GameOptions.cs。 
(2) 输入 如 下 代码 : 


using System; 
namespace KarliCards.Gui 


[Serializable] 

public class GameOptions 

{ 
public bool PlayAgainstComputer { get; set; } 
public int NumberOfPlayers { get; set; } 
public int MinutesBeforeLoss { get; set; } 
public ComputerSkillLevel ComputerSkill { get; set; } 

} 

[Serializable] 

public enum ComputerSkillLevel 

{ 
Dumb, 
Good, 
Cheats 

} 

} 


(3) 退回 代码 隐 减 文件 OptionsWindow.xaml.cs, i5$/]— private 字段 来 保存 GameOptions 实例 : 


private GameOptions gameOptions; 


(4) 在 构造 函数 中 添加 以 下 代码 : 


using System.IO; 

using System.Windows; 

using System.Xml.Serialization; 
namespace KarliCards.Gui 


{ 
public partial class OptionsWindow : Window 


private GameOptions gameOptions; 
public OptionsWindow () 
l if (gameOptions == null) 
; if (File.Exists("GameOptions.xml")) 
) using (var stream = File.OpenRead("GameOptions.xml")) 
{ 


Var serializer = new XmlSerializer (typeof (GameOptions) ); 
gameOptions = serializer .Deserialize (stream) as GameOptions; 
} 
} 
else 
gameOptions = new GameOptions(); 


InitializeComponent (); 


} 
(5) 转 到 设计 视图 ， 分 别 双击 三 个 RadioButton 控件 ， 在 代码 隐藏 文件 中 添加 Checked 事件 处 理 程序 。 按 照 
如 下 所 示 修 改 处 理 程序 


private void dumbAIRadioButton Checked(object sender, RoutedEventArgs e) 


{ 
gameOptions.ComputerSkill = ComputerSkillLevel.Dumb; 
} 
private void goodAIRadioButton Checked(object sender, RoutedEventArgs e) 
{ 


gameOptions.ComputerSkill = ComputerSkillLevel.Good; 
} 
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private void cheatingAIRadioButton Checked(object sender, RoutedEventArgs e) 
gameOptions.ComputerSkill = ComputerSkillLevel.Cheats; 
} 
(6) 双击 OK 按钮 和 Cancel 按钮 ， 然 后 在 处 理 方法 中 添加 如 下 代码 : 
private void okButton Click(object sender, RoutedEventArgs e) 
{ 


using (var stream = File.Open("GameOptions.xml", FileMode.Create) ) 


var serializer = new XmlSerializer (typeof (GameOptions) ); 
serializer.Serialize(stream, gameOptions); 


} 
Close (); 
} 


private void cancelButton Click(object sender, RoutedEventArgs e) 
gameOptions = null; 
Close (); 
} 
(7) 运行 该 应 用 程序 。 


示例 说 明 

新 类 目前 仅 是 一 系列 可 保存 Options 窗口 中 各 种 值 的 属性 。 我 们 将 其 标记 为 Serializable， 以 便 保 存 为 一 个 
文件 。 

当 用 户 选 中 RadioButton 时 ， 会 发 生 Checked 事件 。 我 们 对 该 事件 进行 处 理 ， 以 便 设 置 GameOptions 实例 
的 ComputerSkillLevel 属性 值 。 


14.4.3 数据 绑 定 


数据 绑 定 是 一 种 以 声明 方式 将 控件 与 数据 关联 到 一 起 的 方法 。 在 Options 窗口 中 ， 通 过 处 理 RadioButton 
的 Checked 事件 ， 来 设置 GameOptions 类 的 ComputerSkillLevel 属性 值 。 这 种 处 理 方式 没什么 问题 ， 我 们 可 以 
通过 代码 和 事件 处 理 程序 来 设置 窗口 中 的 所 有 值 ， 但 通常 ， 更 好 的 办 法 是 直接 将 控件 的 属性 与 对 应 的 数据 绑 定 

一 个 绑 定 (Binding) 关 系 由 以 下 4 个 组 件 构 成 : 
绑 定 目标 : 指定 绑 定 要 应 用 到 的 对 象 
目标 属性 : 指定 要 设置 的 属性 
EVR: 指定 绑 定 使 用 的 对 象 
源 属性 ， 指定 存储 该 数据 的 属性 

不 需要 在 每 次 使 用 时 都 明确 指定 这 4 个 组 件 。 特 别 是 ， 由 于 设置 的 是 绑 定 到 控件 的 一 个 属性 ， 因 此 通病 绑 
定 目标 已 经 被 隐 式 指定 。 

总 是 要 设置 绑 定 源 ， 而 后 才能 使 绑 定 关系 正常 运作 起 来 ， 只 不 过 其 设置 方式 多 种 多 样 。 在 接 下 来 的 小 节 和 和 
第 15 章 中 ， 将 介绍 绑 定 源 数 据 的 几 种 不 同方 法 。 

1. DataContext 控件 

DataContext 控件 用 于 定义 一 个 数据 源 ， 该 数据 源 可 以 绑 定 某 个 元 取 的 所 有 子 元 泰 。 很 多 时 候 ， 经营 用 类 的 
一 个 实例 来 保存 视图 中 的 大 部 分 数据 。 这 种 情况 下 ， 可 将 窗口 的 DataContext 设置 为 该 对 象 的 实例 ， 从 而 可 以 
将 该 类 与 视图 中 的 属性 绑 定 起 来 。 该 方法 将 在 “动态 绑 定 到 外 部 对 象 ” 小 节 中 介绍 。 

2. 绑 定 到 本 地 对 象 


可 绑 定 到 任何 包含 所 需 数据 的 NET 对 象 ， 只 要 纺 详 堪 能 够 定位 该 对 象 即 可 。 如 果 在 使 用 对 象 的 控件 所 在 的 
上 下 文 环境 ( 即 相 同 的 XAML 代码 块 ) 中 可 以 找到 该 对 象 , 束 可 通过 设置 绑 定 的 ElementName 属性 来 指定 绑 定 源 。 
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请 看 对 Options 窗口 中 的 ComboBox 控件 所 做 的 更 改 : 

<ComboBox HorizontalAlignment="Left" Margin="196,58,0,0" VerticalAlignment="Top" 

Width="86" Name="numberOfPlayersComboBox" SelectedIndex="0" 

IsEnabled="{Binding ElementName-playAgainstComputerCheck, Path-IsChecked]" > 

注意 IsEnabled 属性 。 没 有 指定 true 或 false 值 ， 而 是 使 用 了 一 长 串 用 花 括号 括 起 来 的 文本 。 这 种 指定 属性 
值 的 方法 称 为 “标记 扩展 语法 ”， 也 是 一 种 用 于 指定 属性 的 便捷 方法 。 还 可 以 使 用 以 下 写法 : 

<ComboBox HorizontalAlignment="Left" Margin="196,58,0,0" 
VerticalAlignment-"Top" Width-"86" Name-"numberOfPlayersComboBox" 
Selectedindex="0" > 
<ComboBox. IsEnabled> 
«Binding ElementName-"playAgainstComputerCheck" 


Path-"IsChecked" /> 
«/ComboBox.IsEnabled» 


上 面 两 段 示 例 代 码 都 可 将 绑 定 源 设置 为 playAgainstComputerCheck 复 选 枉 。 源 属性 是 通过 Path 指定 的 
IsChecked 属性 。 

绑 定 目标 被 设置 为 IEnabled 属性 。 两 段 示 例 代码 都 通过 将 绑 定 指定 为 该 属性 的 内 容 来 完成 这 种 设置 , 只 不 
过 使 用 了 两 种 不 同 的 语法 而 已 。 最 后 ， 由 于 在 ComboBox 上 进行 绑 定 ， 因 此 也 就 隐 式 指定 了 绑 定 目标 。 

本 例 中 的 这 一 绑 定 关系 可 以 让 ComboBox 的 IsEnabled 属性 随 着 CheckBox 的 IsChecked 属性 值 自动 进行 设 
置 或 清除 。 结 果 ， 我 们 没有 使 用 任何 代码 ， 就 可 以 在 用 户 更 改 CheckBox 的 值 时 局 用 和 禁用 ComboBox. 


3. 静态 绑 定 到 外 部 对 象 


通过 在 XAML 中 将 菏 个 类 指定 为 一 项 资源 ， 融 可 以 动态 创建 对 象 实例 。 有 具体 的 方法 融 是 首先 在 XAML 中 
添加 相应 的 名 称 空间 ， 以 便 可 以 找到 这 个 类 ， 然 后 在 XAML 的 某 个 元 素 中 将 类 声明 为 资源 。 
可 在 布 望 进 行 数据 绑 定 的 对 象 的 父 元 又 中 创建 资源 引用 。 


注意 : 


如 果 按 眼前 面 几 节 的 介绍 ， 修 改 了 ComboBox， 则 应 该 删除 IsEnabled 绑 定 来 撤消 更 改 。 


试 一 试 ”创建 静态 数据 绑 定 : KarliCards.Gui\NumberOfPlayers.cs 


在 本 例 中 ， 将 新 建 一 个 用 来 保存 Options 窗口 中 ComboBox 数据 的 新 类 ， 并 将 其 与 该 控件 绑 定 起 来 。 
(1) 在 项 目 中 新 建 一 个 类 ， 并 将 其 命名 为 NumberOfPlayvers.cs。 

(2) 添加 如 下 代码 : 

using System.Collections.ObjectModel; 


namespace KarliCards.Gul 


{ 
public class NumberOfPlayers : ObservableCollection<int> 
{ 
public NumberoOfPlayers () 
: base [) 
Add (2); 
Add (3); 
Add (4); 
} 
} 
} 


(3) 在 OptionsWindow.xaml 文件 中 ,选择 包含 ComboBox 的 Canvas 元 素 ， 并 将 下 列 代码 添加 到 其 下 方 , 但 
要 在 TabControl 声明 之 前 : 
<Canvas . Resources> 


«local:NumberOÍPlayers x:Key-"numberOÍPlayersData" /> 
«/Canvas.Resources- 


(4) 选择 ComboBox， 并 从 中 删除 三 个 ComboBoxlItem. 


320 | 第 中 部 分 Windows 编程 


ItemsSource="{Binding Source={StaticResource numberOfPlayersData]]" 


示例 说 明 
在 本 例 中 ,我 们 完成 了 多 项 工作 。NumberOfPlayers 类 继承 目 一 个 特殊 集合 ObservableCollection。 这 个 基 类 
是 一 个 进行 过 扩展 的 集合 ， 以 使 其 能 在 WPF 中 更 好 地 发 挥 作 用 。 在 该 类 的 构造 函数 中 ， 我 们 为 该 集合 添加 了 

几 个 值 。 

接 下 来 在 Canvas 中 新 建 了 一 个 资源 。 其 实 可 在 ComboBox 的 任意 父 元 素 中 创建 这 个 资源 。 一 旦 在 元 素 中 
指定 了 某 个 资源 ， 它 的 所 有 子 元 素 就 部 可 以 使 用 这 一 资源 。 

最 后 通过 ItemsSource 设置 了 绑 定 关系 。ItemsSource 属性 被 设计 用 于 在 项 控件 中 ， 为 项 集合 设置 绑 定 。 在 
绑 定 中 ， 只 需要 指定 绑 定 源 。 绑 定 目标 、 目 标 属 性 和 源 属 性 的 设置 都 是 在 ItemsSource 属性 中 进行 处 理 的 。 


4. 动态 绑 定 到 外 部 对 象 

现在 ， 可 绑 定 到 根据 需要 动态 创建 的 对 象 ， 以 便 为 它们 提供 数据 。 在 布 望 对 一 个 现 有 实例 化 对 象 进行 数据 
绑 定 时 ， 我 们 应 该 使 用 什么 方法 呢 ? 这 种 情况 下 ， 需 要 在 代码 中 加 一 点 料 。 

以 Options 窗口 为 例 ， 我 们 并 不 希望 其 中 的 选项 在 每 次 打开 窗口 时 都 被 清除 ， 而 是 希望 用 户 所 做 的 选择 可 
以 被 保存 下 来 ， 并 且 可 用 在 应 用 程序 的 其 余部 分 。 

在 下 和 面 的 示例 代码 中 将 DataContext 属性 的 值 设置 为 GameOptions 类 的 实例 ， 就 可 以 实现 该 类 的 属性 的 动 


试 一 试 ”创建 动态 绑 定 : KarliCards.Gui\GameOptions.cs 


在 本 例 中 ， 我 们 会 将 Options 窗口 中 其 余 的 控件 与 GameOptions 实例 绑 定 起 来 。 
(1) 打开 OptionsWindow.xaml.cs 代码 隐 兰 文件 。 
(2) 在 构造 函数 的 压 部 ， 在 InitializeComponent0 这 一 行 之 前 添加 以 下 代码 : 


DataContext = gameOptions; 
(3) 转 到 GameOptions 类 ， 对 其 进行 修改 ， 如 下 所 示 : 


using System; 
using System.ComponentModel; 


namespace KarliCards.Gui 


[Serializable] 
public class GameOptions 
{ 
private bool playAgainstComputer = true; 
private int numberOfPlayers = 2; 
private ComputerSkillLevel computerSkill = ComputerSkillLevel.Dumb; 


public int NumberOfPlayers 


get [ return numberOfPlayers; } 
set 
{ 
numberOfPlayers = value; 
OnPropert yChanged (nameof (NumberOfPlayers) ); 
} 


} 
public bool PlayAgainstComputer 
{ 


get { return playAgainstComputer; } 
set 
{ 
playAgainstComputer = value; 
OnPropertyChanged (nameof (PlayAgainstComputer) ); 
} 
} 
public ComputerSkillLevel ComputerSkill 
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{ 
get { return computerSkill; } 
set 
{ D 
computerSkill = value; 
OnPropertyChanged (nameof (ComputerSkill)); 
] 
} 
public event PropertyChangedEventHandler PropertyChanged; 
private void OnPropertyChanged (string propertyName) 
{ 
PropertyChanged?.Invoke (this, new 
PropertyChangedEventArgs (propertyName)); 


} 
} 
[Serializable] 
public enum ComputerSkillLevel 
{ 
Dumb, 
Good, 
Cheats 
} 


} 

(4) 返回 OptionsWindow.xaml 文件 ， 选 择 CheckBox， 然 后 添加 IsChecked 属性 ， 如 下 所 示 : 

IsChecked="{Binding Path=PlayAgainstComputer}" 

(5) 选择 ComboBox, 然后 按照 如 下 方式 进行 修改 ,删除 SelectedIndex 属性 ,修改 ItemsSource # SelectedValue 
属性 : 

<ComboBox HorizontalAlignment-"Left" Margin="196,58,0,0" VerticalAlignment-"Top" 

Width-"86" Name-"numberOfPlayersComboBox" 

ItemsSource-"(Binding Source={StaticResource numberOfPlayersData]]" 


SelectedValue-"[Binding Path-NumberOfPlayers)" /> 


(6) 运行 该 应 用 程序 。 


示例 说 明 

将 窗口 的 DataContext 设置 为 GameOptions 实例 后 ， 可 以 通过 指定 绑 定 中 使 用 的 属性 很 方便 地 绑 定 到 该 实 
例 。 这 就 是 在 第 (4)、(G5) 步 中 实现 的 。 需 要 注意 ，ComboBox 是 通过 一 个 静态 资源 中 的 项 来 填充 的 ， 但 选 定 的 值 
在 GameOptions 实例 中 设置 。 

GameOptions 类 发 生 了 较 大 变化 。 它 实现 了 INotifyPropertyChanged 接口 , 也 就 是 说 ， 当 属性 值 友 生变 化 时 ， 
这 个 类 就 会 通知 WPF。 为 让 这 个 通知 生效 ， 我 们 需要 让 订阅 方 调 用 上 述 接口 中 定义 的 PropertyChanged 事件 。 
为 此 ， 属 性 设置 器 必须 主动 对 它们 进行 调用 ， 这 一 调用 是 通过 辅助 方法 OnPropertyChanged 来 实现 的 。 

调用 OnPropertyChanged 方法 时 ， 使 用 了 CH 6 引入 的 新 表达 式 nameof。 通 过 一 个 表达 式 调 用 nameof(...) 
时 ， 它 将 检索 最 终 标识 符 的 名 称 。 这 在 OnPropertyChanged 方法 中 特别 有 用 ， 因 为 它 把 要 更 改 的 属性 名 作为 一 
个 字符 串 。 

OK 按钮 的 事件 处 理 程序 使 用 XmlSerializer 将 设置 保存 到 磁盘 中 ， 而 Cancel 事件 处 理 程序 将 GameOptions 
字段 设置 为 null， 这 样 可 以 确保 用 户 所 做 的 选择 可 以 被 清除 挥 。 这 两 个 事件 处 理 程序 都 会 执行 关闭 窗 口 的 操作 。 


14.4.4 使 用 ListBox 控件 启动 游戏 


现在 ， 在 洲 戏 中 ， 我 们 只 剩 下 一 个 提供 文 持 的 窗口 需要 创建 了 了。 在 创建 洲 戏 主 界面 之 前 ， 最 后 一 个 窗口 用 
于 让 玩家 添加 新 的 玩家 ， 以 及 指定 在 新 一 轮 游戏 中 有 哪些 玩家 需要 加 入 。 该 窗口 使 用 一 个 ListBox 控件 来 显示 
玩家 的 名 字 。 

X835, ListBox 和 ComboBox 控件 的 作用 是 类 似 的 ， 只 不 过 ComboBox 控件 一 般 只 能 选择 一 项 ， 而 ListBox 
允许 用 户 选择 多 项 。 男 一 个 显著 差异 是 ListBox 控件 用 于 显示 其 内 容 的 列表 总 处 于 展开 状态 。 也 就 是 说 , ListBox 
控件 会 占用 窗口 中 更 多 的 空间 ， 但 用 户 可 以 立即 看 到 相应 的 选项 。 

X 14-9 中 列 出 了 ListBox 控件 一 些 比较 重要 的 属性 。 
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表 14-9 ListBox 控件 的 重要 属性 
属 性 说 明 

该 属性 控制 用 户 在 列表 中 进行 选择 的 方式 。 可 以 有 三 种 取 值 : Single， 只 人 允许 用 户 选择 一 项 ，Multiple， 人 允许 用 
SelectionMode | 户 不 必 按 下 Ctrl 键 即 可 选择 多 项 ; Extended， 人 允许 用 户 通过 按 下 Shift 键 选 择 连续 的 多 项 ， 或 者 按 下 Ctrl 键 选 择 
SelectedItem 获取 或 设置 第 一 个 被 选中 的 项 ， 如 果 没 有 被 选项 ， 返 回 null。 即 使 有 多 项 被 选中 ， 也 仅 返 回 第 一 项 
SelectedItems 获取 包含 当前 所 有 已 选中 项 的 列表 

与 SelectedItem 关 似 ， 不 同 之 处 在 于 仅 返 回 所 选项 的 索引 值 ， 而 不 是 项 本 身 。 如 果 没 有 被 选项 ， 返 回 -1， 而 不 

是 null 


SelectedIndex 
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试 一 试 ” 创 建 启动 游戏 窗口 : KarliCards.Gui\StartGameWindow.xaml 


该 窗口 会 在 新 游戏 开始 之 前 显示 给 用 户 。 用 户 可 以 在 其 中 输入 目 己 的 名 字 ， 也 可 以 从 已 知 玩家 的 列表 中 选 
择 已 经 存在 的 名 字 。 

(1) 新 建 一 个 窗口 ， 将 其 命名 为 StartGameWindow.xaml. 

(2) 删除 该 窗口 中 的 Grid 元 素 ， 并 将 OptionsWindow.xaml 窗口 中 的 主 Grid 元 素 及 其 内 容 复制 到 新 建 的 窗 
口中 。 

(3) 将 Grid.Row 属性 值 为 1 的 那个 Canvas 控件 中 的 所 有 内 容 删除 。 

(4) 将 窗口 标题 修改 为 Start New Game， 并 设置 以 下 属性 : 

Height="345" Width="445" ResizeMode="NoResize" 

(5) 将 网 格 第 一 行 (编号 为 0) 中 Label 的 内 容 改 为 New Game. 

(6) 打开 GameOptions.cs 文件 ， 并 将 下 列 字 段 添加 到 该 类 的 顶部 : 

private ObservableCollection<string> playerNames = 

new ObservableCollection«string»(); 

public List<string> SelectedPlayers { get; set; } = new List<string>(); 

(7) 上 面 这 段 代 码 用 到 了 System.Collections.Generic 和 System.Collections.ObjectModel 名 称 空 间 , 所 以 使 用 
以 下 语句 : 


using System.Collections.Generic; 
using System.Collections.ObjectModel; 


(8) 为 该 类 添加 一 个 属性 和 两 个 方法 ， 如 下 所 示 : 


public ObservableCollection<string> PlayerNames 


{ 

{ 
return playerNames; 

} 

set 

{ 
playerNames = value; 
OnPropertyChanged ("PlayerNames") ; 

} 


public void AddPlayer (string playerName) 


if (playerNames.Contains (playerName) ) 
return; 
playerNames.Add(playerName); 
OnPropertyChanged ("PlayerNames"); 
} 


(9) 返回 StartGameWindow.xaml 窗口 。 
(10) 在 Canvas 的 下 方 ， 即 网 格 行 1 中 添加 一 个 ListBox 控件 、 两 个 Label 控件 、 一 个 TextBox 控件 以 及 一 
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个 Button 控件 ， 并 按照 图 14-13 所 示 的 布局 和 外 观 修 改 这 些 控件 。 


T. i 
wrox Programmer to Programmer™ New Game 


Players New Player 


图 - 
(11) 按照 表 14-10 所 示 设 置 控 件 的 Name 属性 。 


表 14-10 Name 属性 


B] 8 Name 
TextBox newPlayerTextBox 
Button addNewPlayerButton 
ListBox playerNamesListBox 


(12) i& ListBox 的 ItemsSource 属性 ， 如 下 所 示 : 


ItemsSource=" {Binding Path=PlayerNames}" 
(13) 在 代码 隐藏 文件 中 为 ListBox 添加 SelectionChanged 事件 处 理 程序 ， 并 添加 如 下 代码 : 


private void playerNamesListBox SelectionChanged(object sender, 
SelectionChangedEventArgs e) 
{ 
if (gameOptions.PlayAgainstComputer) 
okButton.IsEnabled = (playerNamesListBox.SelectedItems.Count == 1); 
else 
okButton.IsEnabled = (playerNamesListBox.SelectedItems.Count == 
gameOptions.NumberOfPlayers); 
} 


(14) 在 该 类 的 开头 添加 以 下 字段: 
private GameOptions gameOptions; 
(15) 将 OK 按钮 的 IsEnabled 属性 设置 为 false. 
(16) 从 OptionsWindow.xaml.es 代码 隐 兰 文件 中 复制 构造 国 数 (注意 不 要 仅 复制 其 名 称 )， 并 在 代码 末尾 的 
InitializeComponent 之 后 添加 下 列 代 码 ( 别 志 了 为 System.IO 和 System.Xml. Serialization 添加 using 声明 ): 
if (gameOptions.PlayAgainstComputer) 
playerNamesListBox.SelectionMode = SelectionMode.Single; 


else 
playerNamesListBox.SelectionMode = SelectionMode.Extended; 


(17) 选择 Add 按钮 ， 并 为 其 添加 Click 事件 处 理 程序 。 添 加 如 下 代码 : 


private void addNewPlayerButton Click(object sender, RoutedEventArgs e) 
{ 
if (!string.IsNullOrWhiteSpace (newPlayerTextBox. Text) ) 
gameOptions.AddPlayer (newPlayerTextBox.Text); 
newPlayerTextBox.Text = string.Empty; 
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(18) 将 OptionsWindow.xaml.cs 代码 隐藏 文件 中 OK 和 Cancel 按钮 的 事件 处 理 程序 代码 复制 到 当前 这 个 代 
码 隐藏 文件 中 。 
(19) 在 OK 按钮 的 事件 处 理 程序 的 开头 添加 以 下 几 行 代码 : 
foreach (string item in playerNamesListBox.SelectedItems) 
gameOptions.SelectedPlayers.Add(item); 
(20) 转 到 App.xaml 文件 ， 将 StartupUri ix & YW StartGameWindow.xaml. 
(21) 运行 该 应 用 程序 。 


示例 说 明 

首先 在 GameOptions 类 中 添加 了 一 些 代 码 ， 使 其 可 以 保存 所 有 已 知 玩家 的 信息 以 及 用 户 在 StartGame 窗口 
中 所 做 的 当前 选择 。 

ListBox 的 ItemsSource 属性 与 之 前 在 ComboBox 中 看 到 的 类 似 。 Awl, 与 之 前 将 ComboBox 中 的 所 选项 
直接 与 条 个 值 进行 绑 定 不 同 的 是 ， 对 ListBox 进行 绑 定 要 复杂 一 些 。 如 果 符 试 绑 定 SelectedValues 属性 ， 
我 们 会 上 友 现 ， 这 个 属性 其 实 是 只 读 的 ， 不 能 直接 用 于 数据 绑 定 。 这 里 采用 的 解决 办 法 是 通过 编写 代码 ， 使 用 OK 
按钮 来 保存 相应 的 值 。 需 要 注意 ， 这 里 可 以 强制 转换 为 IList<string>， 是 因为 此 时 ListBox 的 内 容 是 字符 串 ， 但 
如 果 我 们 选择 修改 默认 行为 ， 显 示 其 他 内 容 ， 那 么 所 选择 的 项 也 必须 进行 更 改 。 

当 ListBox 中 的 已 选项 发 生变 化 时 ， 就 会 触发 SelectionChanged 事件 。 此 时 ,我 们 要 处理 该 事件 ， 以 便 确定 
所 选项 的 数目 是 寿 正确 。 如 果 玩 家 选择 与 电脑 进行 对 战 ， 那 么 只 有 一 个 真正 的 玩家 ; 否则 ， 必 须 选 择 相应 数量 
的 玩家 名 字 。 


注意 : 


第 15 章 将 介绍 样式 、 控 件 和 项 模板 ， 还 将 介绍 为 什么 我 们 不 能 随时 了 解 控件 的 内 容 类 型 是 什么 。 


14.5 “习题 


(1) TextBlock 控件 可 用 来 显示 大 量 文本 内 容 ， 但 如 果 文 本 内 容 超过 了 控件 区 域 的 大 小 ， 那 么 并 不 提供 滚动 
功能 。 请 将 TextBlock 和 另 一 种 控件 结合 起 来 ， 创 建 一 个 可 包含 大 量 文本 内 容 ， 并 且 仅 当 文本 内 容 超 出 显示 区 
域 时 才 会 出 现 深 动 条 的 窗口 。 

(2) Slider 和 ProgressBar 控件 具有 一 些 相 同 的 属性 ， 例 如 最 小 值 、 最 大 值 和 当前 什 。 仅 在 ProgressBar 
控件 上 使 用 数据 绑 定 ， 创 建 一 个 包含 侧 边栏 和 进度 条 的 窗口 ， 且 Slider 控件 可 以 控制 进度 条 的 最 小 值 、 最 大 值 
和 当前 值 。 

(3) 将 前 一 题 中 的 ProgressBar 控件 修改 为 从 窗口 左下 角 到 右上 角 沿 对 角 线 显示 。 

(4) 新 建 一 个 名 为 PersistentSlider， 且 包含 MinValue. MaxValue 和 CurrentValue 三 个 属性 的 类 。 这 个 类 应 
该 支持 数据 绑 定 ， 并 且 所 有 属性 都 可 将 更 改 通知 给 绑 定 的 控件 。 

a. 在 前 两 个 习题 所 创建 的 窗口 的 代码 隐藏 文件 中 新 建 一 个 PersistentSlider 类 型 的 字段 ， 并 使 用 一 些 默认 值 
对 其 进行 初始 化 。 

b. 在 构造 函数 中 将 该 实例 比 定 到 窗口 数据 源 。 

c. 将 Slider 的 Minimum, Maximum 和 Value 属性 绑 定 到 数据 源 。 

附录 A 给 出 了 习题 答案 。 
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E a 要 A 
XAML XAML 是 一 种 使 用 XML 语法 ， 并 且 通 过 层级 式 声明 方式 将 控件 添加 到 用 户 界 面 的 语言 
可 使 用 数据 绑 定 将 控件 的 茶 些 属性 和 其 他 控件 的 值 链 接 起 来 。 也 可 以 通过 定义 资源 的 方式 将 当 
数据 绑 定 前 视图 之 外 的 类 中 所 定义 的 代码 用 作 数 据 源 ， 既 可 以 是 属性 的 值 ， 也 可 以 是 控件 的 内 容 。 


DataContext 可 用 于 指定 现 有 对 象 实例 的 绑 定 源 ， 从 而 允许 绑 定 到 应 用 程序 其 他 位 置 所 创建 的 实例 
路 由 事件 是 WPF 中 的 特殊 事件 ， 主 要 有 两 种 事件 : 冒 泡 事件 和 下 外 事件。 冒 泡 事件 首先 在 触发 
它们 的 控件 上 调用 ， 然 后 一 级 一 级 往 上 传递 ， 直 到 视图 树 的 根 元 素 。 而 下 钻 事件 则 不 同 ， 是 从 


— 根 元 素 问 用 户 触发 的 控件 传递 。 这 两 种 事件 都 可 以 通过 将 事件 参数 的 Handled 属性 设置 为 true 
的 方式 来 终止 
| | INotifyPropertyChanged 接口 由 WPF 视图 中 使 用 的 一 个 类 来 实现 。 当 该 类 的 属性 设置 器 被 调用 
INotifyPropertyChanged " : " pM MCN 
- 时 ， 就 会 触发 PropertyChanged 事件 ， 并 在 事件 中 包含 发 生 更 改 的 属性 名 。 所 有 与 触发 事件 的 属 
| 性 绑 定 在 一 起 的 控件 属性 都 会 得 到 通知 ， 以 便 相 应 地 更 新 自己 的 值 
NM ObservableCollection 集合 的 一 个 作用 是 实现 INotifyPropertyChanged 接口 。 当 我 们 希望 将 属性 或 
ObservableCollection 集合 | | | | | 
值 的 列表 提供 给 WPF 视图 进行 数据 绑 定 时 ， 可 使 用 这 一 特殊 集合 
m 内 容 控 件 可 在 其 内 容 中 包含 一 个 控件 。 例 如 ，Button 就 是 一 个 内 容 控 件 。 控 件 可 以 是 Grid 或 


StackPanel; 并 且 可 以 进行 复 录 的 目 定 义 
项 控件 项 控件 可 以 在 其 内 容 中 包含 一 系列 控件 ， 例 如 ListBox。 列 表 中 的 每 个 控件 都 可 以 进行 目 定义 
我 们 还 学 习 了 许多 有 助 于 创建 视图 的 控件 ; 
e Canvas 允许 显 式 放置 控件 ， 但 其 他 功能 束 很 少 
è StackPanel 在 水 平 或 垂直 方向 上 排列 控件 
e WrapPanel 可 根据 面板 方 问 排列 控件 ， 并 目 动 换 到 下 一 行 或 下 一 列 
è DockPanel 可 让 控件 停靠 到 控件 的 边 上 ， 或 充满 整个 内 容 区 域 
e Grid 可 定义 多 行 或 多 列 ， 并 借助 这 些 行 和 列 来 放置 控件 
UI 控 件 用 于 在 视图 中 显示 特定 内 容 , 通常 使 用 布局 控件 来 帮助 摆 放 它们 。 这些 控 件 及 其 作用 包括 : 
o Label 控件 用 于 显示 简短 文字 
e TextBlock 控件 用 于 显示 可 能 需要 多 行 显示 的 文字 
e TextBox 控件 让 用 户 可 以 输入 需要 的 文字 内 容 
e Button 控件 让 用 户 可 以 执行 某 项 操作 


布局 控件 


UI 控 件 e CheckBox 让 用 户 可 以 回答 诸如 “是 否 与 计算 机 对 战 ?” 的 是 / 否 问题 
e RadioButton 让 用 户 可 以 从 多 个 选项 中 选择 一 项 
e ComboBox 用 于 显示 包含 一 系列 可 选项 的 下 拉 列 表 , 用 户 可 从 列表 中 选择 一 项 。 该 控件 还 可 
以 显示 一 个 TextBox， 让 用 户 输入 其 他 选项 
e ListBox 控件 也 可 以 通过 列表 形式 显示 选项 。 与 ComboBox 不 同 ，ListBox 总 是 展开 的 。 它 还 
允许 选择 多 项 
e TabControl 允许 将 控件 分 组 放 到 不 同 页 面 上 
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REAR: 

e 如 何 使 用 路 由 命令 来 代 蔡 事件 

e 如 何 使 用 XAML 样式 来 设置 控件 和 应 用 程序 的 样式 

e 如 何 使 用 Menu 控件 和 路 由 命令 来 创建 菜单 

e lj] titia 

e ”如 何 使 用 时 间 线 来 创建 动画 

e ”如 何 定 义 和 引 用 静态 及 动态 资源 

e 如 何在 利用 控件 不 请 足 需 要 时 创建 用 户 控件 

本 章 源 代码 可 以 通过 本 书 合 作 站 点 wrox.com 上 的 Download Code 选项 卡 下载 ， 也 可 以 通过 网 址 


http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapterl5 文件 夹 中 并 已 根据 本 章 示 例 的 
名 称 单独 命名 。 


到 目前 为 止 , 我 们 使 用 WPF 的 方式 与 Visual Studio 中 创建 Windows 应 用 程序 的 另 一 种 主流 技术 一 一 
Windows Forms 十 分 类 似 。 但 接 下 来 介绍 的 内 容 就 有 所 不 同 了 。WPF 可 设置 所 有 控件 的 样式 ， 使 用 模板 让 现 有 
控件 看 起 来 不 再 是 原生 的 外 观 。 此 外 ， 我 们 还 将 直接 输入 XAML， 学 习 更 多 知识 。 虽 然 编 写 XAML 一 开始 看 
起 来 很 难 , 而 通过 设置 属性 来 移动 或 调整 控件 的 外 观 很 容易 上 手 , 但 XAML 可 以 实现 许多 在 设计 器 中 无 法 实现 
的 功能 ， 例 如 创建 动画 。 


15.1 创建 控件 并 设置 样式 


WPF 的 一 个 最 佳 特性 是 允许 设计 人 员 完全 控制 用 户 界面 的 外 观 和 操作 方式 。 其 核心 是 可 以 根据 需要 设置 控 
件 的 二 维 或 三 维 样式 。 前 面 只 使 用 了 NET 为 控件 提供 的 基本 样式 ， 但 实际 上 可 设置 任意 多 种 不 同 的 样式 。 

本 节 介绍 两 个 基本 技术 : 

。 样式 一 -批量 设置 要 应 用 到 控件 上 的 某 些 属性 

。 模板 一 -在 其 基础 上 设置 控件 外 观 的 控件 
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这 两 种 技术 会 有 一 些 重 登 ， 因 为 样式 可 以 包含 模板 。 


15.1.1 样式 


WPF 控件 有 一 个 Style 属性 (继承 日 FrameworkElement)， 它 可 以 设置 为 Style 类 的 实例 。Style 类 相当 复杂 ， 
可 用 来 实现 高 级 的 样式 功能 , 但 其 核心 实际 上 也 就 是 一 组 Setter 对 象 ,每 个 Setter 对 象 都 根据 其 Property 属性 (要 
设置 的 属性 名 称 ) 和 Value 属性 (要 赋 给 属性 的 值 )， 来 设置 一 个 属性 的 值 。 可 将 Property 中 使 用 的 名 称 完全 限定 
为 控件 类 型 (例如 Button.Foreground)， 也 可 设置 Style 对 象 的 TargetType 属性 (例如 Button)， 以 便 解 析 属 性 名 称 。 

下 面 的 代码 展示 了 如 何 使 用 Style 对 象 来 设置 Button 控件 的 Foreground 属性 : 


<Button> 
Click me! 
<Button.Style> 
<Style TargetType="Button"> 
<Setter Property="Foreground"> 
<Setter .Value> 
«SolidColorBrush Color-"Purple" /> 
«/Setter.Value» 
</Setter> 
</Style> 
</Button.Style> 
</Button> 


显然 ， 对 于 上 述 代 码 ， 用 通常 方式 设置 Button 控件 的 Foreground 属性 会 简单 得 多 。 将 样式 转变 为 资源 时 ， 
样式 就 会 非 营 有 用 ， 因 为 资源 可 供 重 复 使 用 。 


15.1.2 模板 


控件 用 模板 构建 ， 而 模板 可 以 目 定义 。 模 板 由 一 系列 控件 组 成 ， 这 些 控件 按 层次 结构 组 合 起 来 ， 构 成 了 我 
们 看 到 的 控件 ， 其 中 可 能 包含 用 于 呈现 内 容 的 控件 ， 例 如 显示 内 容 的 按钮 。 

控件 的 模板 保存 在 Template 属性 中 ， 而 Template 属性 是 ControlTemplate 类 的 实例 。ControlTemplate KES 
TargetType 属性 ， 该 属性 可 以 设置 为 用 于 定义 模板 的 控件 类 型 。 

通常 ， 通 过 样式 为 类 设置 模板 。 方 法 是 按 以 下 方式 在 Template 属性 中 提供 要 使 用 的 控件 : 


<Button> 
Click me! 
<Button.Style> 
<Style TargetType="Button"> 
«Setter Property="Template"> 
<Setter .Value> 
«ControlTemplate TargetType-"Button"- 


«/ControlTemplate» 
</Setter.Value> 
</Setter> 
</Style> 
«/Button.Style- 

</Button> 

某 些 控件 可 能 需要 多 个 模板 。 例 如 ，CheckBox 控件 为 复 选 框 使 用 一 个 模板 (CheckBox.Template)， 为 复 选 框 
笼 的 输出 文本 使 用 男 一 个 模板 (CheckBox.ContentTemplate)。 

青 要 呈现 内 容 的 模板 都 可 在 需要 输出 内 容 的 位 置 包 含 一 个 ContentPresenter 控件 。 

在 第 14 章 中 创建 的 3 个 对 话 框 在 外 观 和 操作 方式 上 都 很 相似 。 这 些 对 话 框 共有 的 一 个 元 素 是 header， 第 
14 章 在 header 中 修改 了 每 个 对 话 框 的 标签 文本 。 可 将 header 定义 为 标签 ， 下 例 开 发 了 一 种 新 的 Label 样式 并 用 


它 蔡 代 了 4 个 对 话 框 中 的 header. 


试 一 试 ”创建 主 窗口 : KarliCards.Gui\GamecClientWindow_.xaml 


(1) 右 击 项 目 ， 然 后 选择 Add | Resource Dictionary， 创 建 一 个 新 的 Resource Dictionary， 命 名 为 ControlRe- 


sources.xaml. 


第 15 章 


(2) 为 标签 新 建 一 个 Control Template. 


«ControlTemplate x:Key="HeaderTemplate" TargetType="{x:Type Label}"> 
<Canvas Background="#C40D42" > 
<Image Height="56" Canvas.Left="0" Canvas.Top="0" 
Stretch-"UniformToFill" Source=".\Images\Banner.png"/> 
«ContentPresenter Canvas.Right="10" Canvas .Top="25" 
Content="{TemplateBinding Content}" /> 
</Canvas> 
</ControlTemplate> 


(3) 添加 一 种 包含 Control Template 的 样式 : 


«Style x:Key="HeaderLabelStyle" TargetType-"Label"- 
«Setter Property="Template" Value="{StaticResource HeaderTemplate}" /> 
<Setter Property="FontFamily" Value="Times New Roman" /> 
«Setter Property=" FontSize" Value="24" /> 
<Setter Property="FontWeight" Value="Bold" /> 
«Setter Property-"Foreground" Value="#FFF7EFEF" /> 
</style> 


(4) 新 建 一 个 窗口 ， 命 名 为 GameClientWindow.xaml. 
(5) 将 标题 改 为 Karli Cards Game Client， 删 除 Height 和 Width 属性 。 
(6) 设置 WindowState 属性 的 值 为 Maximized. 
(7) 在 窗口 的 项 部 ，Grid 的 前 面 ， 导 入 Resource Dictionary， 如 下 所 示 : 
<Window.Resources> 
<ResourceDictionary> 
<ResourceDictionary .MergedDictionaries> 
<ResourceDictionary Source="ControlResources.xaml" /> 
</ResourceDictionary .MergedDictionaries> 
</ResourceDictionary> 
</Window. Resources> 


(8) f£ Grid 控件 中 插入 网 格 的 行 定义 ， 如 下 所 示 : 


<Grid.RowDefinitions> 
<RowDefinition Height="58"/> 
<RowDefinition Height="20"/> 
<RowDefinition /> 
<RowDefinition Height="42"/> 

</Grid.RowDefinitions> 


(9) RË Canvas， 这 次 插入 一 个 新 的 Label 控件 ， 如 下 所 示 : 


<Label Grid.Row="0" Style="{StaticResource HeaderLabelStyle}">Karli Cards</Label> 


示例 说 明 
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查看 控件 模板 时 ， 会 发 现 该 模板 几乎 类 似 于 第 14 章 中 创建 的 窗口 内 的 控件 ， 唯 一 的 区 别 在 于 


ControlTemplate 声明 ， 以 及 使 用 ContentPresenter 取代 了 Label 控件 。 


ControlTemplate TargetType 声明 非常 重要 ， 因 为 它 指定 了 模板 的 目标 控件 。 这 样 ， 束 可 以 将 父 控 件 中 的 绑 


定 属性 用 于 模板 内 的 控件 上 。 碍 看 下 面 的 ContentPresenter 控件 : 


<ContentPresenter Content="{TemplateBinding Content}" /> 


ContentPresenter 控件 允许 指定 控件 类 型 的 内 容 放 到 什么 地 方 。 在 GameClientWindow 中 ， 指 定 Label 的 内 


容 是 Karli Cards， 这 将 使 这 条 文本 显示 出 来 。 这 是 一 种 通 弟 的 做 法 ， 但 ContentPresenter 允许 指定 任何 内 容 ， 就 
如 期 望 通 过 内 容 属 性 指定 任何 内 容 一 样 。 


Style 控件 可 对 任何 想 要 的 标签 属性 进行 设置 ， 但 要 注意 ，Template 属性 应 该 设置 为 对 新 的 HeaderTemplate 


的 引用 : 


<Setter Property="Template" Value="{StaticResource HeaderTemplate}" /> 


15.1.3 fü ES 


WPF 中 的 事件 几乎 无 所 不 包 ， 例 如 按钮 单 击 、 应 用 程序 局 动 和 关闭 事件 等 。 实 际 上 ，WPF 有 几 类 触发 器 
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(Trigger)， 它 们 均 继 承 自 TriggerBase 基 类 。 例 如 EventTrigger 触发 器 类 就 包含 了 一 系列 操作 ， 每 个 操作 都 是 一 
个 派生 自 TriggerAction 基 类 的 对 象 。 激 活 触发 器 时 ， 就 会 执行 相应 的 操作 。 

可 借助 EventTrigger， 调 用 BeginStoryboard 操作 来 触发 动画 ， 调 用 ControllableStoryboardAction 来 操作 故事 
板 (storyboard)， 或 者 调用 SoundPlayerAction 来 甬 上 发 声音 效果 。 

每 个 控件 都 有 Triggers 属性 ， 它 可 用 于 直接 在 该 控件 上 定义 触发 费 。 还 可 以 沿 看 层次 结构 同上 定义 触 友 器 ， 
例如 在 前 面 演 示 的 Window 对 象 上 。 设 置 控件 的 样式 时 ， 最 帝 用 的 触 肥 器 类 型 是 Trigger( 但 仍 使 用 EventTrigger 
触发 控件 动画 )。Trigger 类 用 于 设置 属性 ， 来 啊 应 其 他 属性 的 改变 ， 在 Style 对 象 中 使 用 时 的 效果 尤其 好 。 

fit fs sov] A UB ELA F: 

e 要 定义 Trigger 对 象 监视 的 属性 ， 应 使 用 Trigger.Property 属性 。 

e 要 定义 何 时 激活 Trigger YA, ME. Trigger. Value 属性 。 

e 要 定义 Trigger 触发 的 操作 ， 应 将 Trigger.Setters 属性 设置 为 Setter 对 象 的 一 个 集合 。 

这 里 所 指 的 Setter 对 象 就 是 前 面 15.1.1 一 节 介 绍 的 Setter 对 象 。 

下 面 的 代码 显示 了 在 Style 对 象 中 用 到 一 个 触发 器 : 

«Style TargetType="Button"> 

<Style.Triggers> 
«Trigger Property-"IsMouseOver" Value="true"> 
«Setter Property-"Foreground" Value-"Yellow" /» 
«/Trigger- 
</Style.Triggers> 

</Style> 

上 述 代 码 在 Button. IsMouseOver 属性 为 tue 时 ,将 Button 控件 的 Foreground 属性 设置 为 Yellow。JIsMouseOver 
是 一 个 非常 有 用 的 属性 ， 可 在 查找 控件 信息 或 控件 状态 时 用 作 快捷 键 。 顾 名 思 义 ， 如 果 鼠 标 指针 位 于 某 个 控件 
之 上 ， 则 该 属性 为 ttme。 这 样 束 可 以 为 鼠标 深 轮 编写 代码 。 与 其 类 似 的 属性 包括 Focused， 用 于 确定 控件 是 否 
获得 了 焦点 ，IsHitTestVisible 表示 是 否 可 以 单 击 该 控件 ( 即 控件 没有 被 上 层 堆 登 的 控件 盖 住 )，IsPressed RRI 
个 按钮 是 否 被 按 下 。 最 后 这 个 属性 仅 适 用 于 继承 和 目 ButtonBase 的 按钮 ， 其 他 属性 则 适用 于 所 有 控件 。 

还 可 以 借助 ControlIemplate.Triggers 属性 来 实现 更 多 功能 ， 创 建 包 含 触 及 规 的 控件 模板 。 默 认 的 Button f: 
板 就 采用 这 种 方式 啊 应 女 标 深 轮 深 动 、 单 击 和 焦点 切换 。 只 有 修改 模板 ， 才 能 实现 目 己 的 功能 。 


15.14 动画 


动画 是 通过 故事 板 创 建 的 。 蔡 无 疑问 ， 定 义 动画 的 最 好 方法 束 是 使 用 Expression Blend 这 样 的 设计 颖 。 不 
过 ， 也 可 以 直接 编辑 XAML 代码 来 定义 动画 ， 或 通过 C# 代 码 来 定义 。 


注意 : 


有 关 图 形 动画 的 细节 超出 了 本 书 的 讨论 范围 。 本 节 中 的 内 容 引 在 让 你 大 致 了 解 能 够 使 用 动画 做 些 什 么 。 


WPF 中 的 动画 使 用 Storyboard 对 象 来 定义 。 使 用 故事 板 可 以 以 动画 的 方式 来 设置 属性 值 ， 例 如 ， 按 钮 的 育 
景色 。 需 要 知道 ， 可 以 动画 方式 来 处 理 任 何 属性 ， 而 不 只 是 影 啊 控件 显示 方式 的 属性 。 
可 以 在 Resource Dictionary 中 独立 定义 故事 板 ， 也 可 以 在 控件 中 使 用 事件 触发 右 的 BeginStoryboard 来 定 
义 。 在 故事 板 中 可 定义 一 个 或 多 个 动画 ， 也 就 是 时 间 线 。 
在 上 一 节 中 ， 使 用 触发 器 设置 了 鼠标 在 控件 上 经 过 时 Button 控件 的 前 景色 。 分 析 下 面 的 代码 ， 这 里 使 用 的 
是 故事 板 : 
«Button Content-"Animation" HorizontalAlignment-"Left" Margin-"197,63,0,0" 
VerticalAlignment-"Top" Width="75"> 
<Button.Triggers> 
<EventTrigger RoutedEvent="Button.MouseEnter"> 
<BeginStoryboard> 
<Storyboard> 
<ColorAnimation To="Yellow" 
Storyboard. TargetProperty=" (Button. Foreground) 


. (SolidColorBrush.cColor)" 
FillBehavior-"HoldEnd" 
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Duration-"0:0:1" AutoReverse-"False" /> 
</Storyboard> 
</BeginStoryboard> 
</EventTrigger> 
<EventTrigger RoutedEvent="Button.MouseLeave"> 
<BeginStoryboard> 
<Storyboard> 
«ColorAnimation To-"Black" 
Storyboard.TargetProperty-" (Button. Foreground) 
. (SolidColorBrush.Color)" 
FillBehavior="HoldEnd" 
Duration="0:0:1"/> 
</Storyboard> 
«/BeginStoryboard» 
</EventTrigger> 
</Button.Triggers> 
</Button> 


Button #2 (FE j^ fit A as FP Fl] Hi T MouseEnter 和 MouseLeave. EEA fit as Ab B — AA 
ColorAnimation， 可 分 别 将 文本 的 前 景色 更 改 为 黄色 和 黑色 。 使 用 Trigger 直接 设置 Foreground 属性 和 使 用 故事 
板 进行 设置 在 细节 上 是 不 同 的 。 使 用 故事 板 ， 所 得 到 的 是 一 种 在 1 秒 内 流畅 完成 的 过 渡 ， 但 大 直 接 设 置 属性 ， 
则 过 渡 会 瞬间 发 生 。 只 要 合理 利用 ， 两 者 都 是 非 间 有 用 的 工具 一 一 如 果 使 用 太 多 的 动画 ， 会 干扰 用 户 ， 但 合理 
地 设置 动画 可 以 使 应 用 程序 看 起 来 更 加 精彩 。 


15.2 WPF APH 


图 形 化 的 纸牌 游戏 的 一 个 关键 特征 是 纸牌 ,显然 , 在 WPF 自 带 的 标准 控件 中 并 不 能 找到 Playing Card 控件 ， 
所 以 需要 上 自己 创建 它 。 

WPF 提供 了 一 组 在 许多 情况 下 有 效 的 控件 。 不 过 ， 与 所 有 .NET JDAGEAR—RÉ, WPF 也 允许 扩展 其 功能 。 
比如 ， 可 在 WPF 层次 结构 中 派生 目 己 的 类 ， 以 创建 出 目 己 的 控件 。 

用 户 控件 常 从 UserControl 派生 。 这 个 类 提供 了 WPF 控件 需要 的 所 有 基本 功能 ， 并 保证 自 定 义 控件 与 现 有 
的 WPF 控件 能 统一 起 来 。 我 们 期 望 在 WPF 控件 上 实现 的 所 有 功能 ， 包 括 动 画 、 样 式 、 模 板 ， 都 可 以 通过 用 户 
控件 来 实现 。 

选择 Project | Add User Control 这 单 项 ， 即 可 在 项 目 中 添加 用 户 控 件 。 随 后 ， 就 可 以 得 到 一 个 空白 画布 (实际 
上 是 一 个 空 日 网 格 )。 在 XAML 中 ， 用 户 控 件 通 过 顶层 的 UserControl 元 素来 定义 ， 代 码 隐 藏 文件 中 的 类 继承 日 
System. Windows.Controls.UserControl A. 

EM EH PSI SAP a, BAA ESAE, FES RC PAPE S o TEZ 
后 ， 即 可 在 整个 应 用 程序 中 使 用 这 个 用 户 控 件 ， 甚 至 可 以 在 其 他 应 用 程序 中 重复 使 用 。 

在 创建 用 户 控件 的 过 程 中 ， 最 重要 的 内 容 束 是 了 解 如 何 实现 依 赖 属 性 。 第 14 革 简 要 介绍 了 依赖 属性 ,现在 
要 编写 用 户 控 件 ， 因 此 再 详细 讨论 一 下 依赖 属性 。 

Adis Jes VE By Ds DB Aa KK A System. Windows.DependencyObject 的 类 。 这 个 类 在 WPF 许多 类 的 继承 层 
次 结构 中 ， 包 括 所 有 的 控件 和 UserControl. 

要 在 某 个 类 中 实现 依赖 属性 ， 应 在 类 的 定义 代码 中 添加 一 个 这 有 public 和 static mI 2572 7j System. 
Windows.DependencyProperty 的 成 员 。 该 成 员 可 以 是 任意 名 称 ， 但 最 好 符合 命名 约定 <PropertyName>Property: 

public static DependencyProperty MyStringProperty; 

将 这 个 属性 定义 为 static( 裔 态 ) 似 乎 很 奇怪 ， 这 样 就 可 以 为 该 类 的 所 有 实例 单独 定义 这 个 属性 。WPEF 属性 框 
架 会 一 直 自 动 跟踪 相关 代码 ， 因 此 不 必 担心 。 

添加 的 这 个 成 员 必 须 通过 静态 的 DependencyPropertyRegister( 方 法 来 配置 ， 


public static DependencyProperty MyStringProperty = 
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DependencyProperty.Register(...); 


该 方法 包含 3~5 个 参数 ， 如 表 15-1 所 示 ( 表 中 按照 参数 的 使 用 顺序 罗列 ， 前 3 个 为 必要 参数 )。 
表 15-1 Register( ) 方 法 的 参数 


参数 用 法 
string name 属性 的 名 称 
Type propertyType 属性 的 类 型 
Type ownerType 包含 属性 的 类 的 类 型 
PropertyMetadata u u m | | 
额外 的 属性 设置 : 属性 的 默认 值 ， 以 及 在 属性 变更 通知 和 强制 类 型 转换 时 用 到 的 回调 方法 

typeMetadata 
Validate ValueCallback | | 

oe y 用 于 验证 属性 值 的 回调 方法 
validate ValueCallback 

注意 : 


还 有 其 他 方法 也 可 以 注册 依赖 属性 ， 例 如 ResgisterAttached0， 可 用 来 实现 附加 属性 。 本 章 不 介绍 这 些 方法 ， 
不 过 它们 的 确 值 得 我 们 进一步 学 习 。 


例如 ， 使 用 三 个 参数 就 可 以 注册 MyStringProperty 依赖 属性 : 
public class MyClass : DependencyObject 
public static DependencyProperty MyStringProperty = DependencyProperty.Register ( 
"MyString", 
typeof (string), 
typeof (MyClass)); 

} 

还 可 以 添加 一 个 .NET 属性 ， 用 于 直接 访问 依赖 属性 ( 它 不 是 必需 的 ， 如 下 所 述 )。 不 过 ， 由 于 依赖 属性 定义 
为 静态 成 员 ， 因 此 不 能 像 使 用 普通 属性 那样 使 用 它 。 要 访问 依赖 属性 的 值 ， 必 须 使 用 继承 自 DependencyObject 
的 方法 ， 如 下 所 示 : 

public string MyString 

{ 
get { return (string) GetValue (MyStringProperty); } 
set { SetValue (MyStringProperty, value); } 

} 


其 中 ，GetValue0 和 SetValue0 方 法 分 别 获取 和 设置 MyStringProperty( 即 当前 实例 的 依赖 属性 ) 的 值 。 这 两 个 
方法 是 公共 (public) 方 法 ， 因 此 客户 端 代 码 可 以 直接 通过 它们 来 操作 依赖 属性 的 值 。 这 也 说 明了 为 什么 不 添 
加 NET 属性 也 可 以 访问 依赖 属性 。 

如 果 需 要 设置 属性 的 元 数据 ， 束 必 须 使 用 继承 日 PropertyMetadata 的 对 象 ， 例 如 Framework- 
PropertyMetadata， 并 将 该 实例 作为 第 4 个 参数 传递 给 Register0 方 法 。FrameworkPropertyMetadata 的 构造 函数 有 
11 个 重 载 版 本 ， 每 个 构造 函数 都 带 有 表 15-2 所 示 的 一 个 或 多 个 参数 。 


表 15-2 FrameworkPropertyMetadata 构造 国 数 的 重 载 版 本 


参数 类 型 用 法 
object defaultValue 属性 的 默认 值 
FrameworkPropertyMetadata- 该 参数 是 一 系列 标志 的 组 合 (来 自 FrameworkPropertyMetadataOptions 枚 举 )， 用 于 为 属性 指定 
Options flags 额外 的 元 数据 。 例 如 ， 使 用 AffectsArrange 来 声明 属性 的 变更 可 能 会 影 啊 控件 的 布局 。 使 窗 
口 的 布局 引擎 在 属性 发 生变 化 时 重新 计算 控件 的 布局 。 有 关 此 处 可 用 的 所 有 选项 ， 请 参见 
MSDN 文档 


PropertyChangedCallback 属性 值 更 改 时 要 调用 的 回调 方法 
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propertyChangedCallback 
( 续 表 ) 
参数 类 型 用 法 
CoerceValueCallback 强制 转换 属性 值 的 类 型 时 要 调用 的 回调 方法 
coerce ValueCallback 
bool isAnimationProhibited 指定 该 属性 是 否 可 在 动画 过 程 中 发 生变 化 
UpdateSourceTrigger 当 属性 值 进行 了 数据 绑 定 时 ， 该 属性 会 根据 UpdateSourceTrigger 枚 举 值 的 不 同 ， 确 定数 据 源 
defaultUpdateSourceTrigger 何 时 更 新 。 默 认 值 为 PropertyChanged， 表 示 绑 定 源 会 随 着 属性 值 更 改 。 并 非 所 有 时 候 都 需要 


这 样 处 理 , 例如 TextBox.Text /& TERA] LEAR LostFocus 值 (在 丢失 焦点 时 更 新 )。 这 样 可 以 避 
倪 绑 定 源 过 早 更 新 。 还 可 以 使 用 Explicit 值 ， 指 定 绑 定 源 仪 在 被 请 求 时 才 更 新 (通过 调用 继承 
El DependencyObject 的 类 的 UpdateSource0 方 法 ) 


下 面 的 简单 例子 演示 了 如 何 使 用 FrameworkPropertyMetadata 来 设置 属性 的 默认 值 : 


public static DependencyProperty MyStringProperty = 
DependencyProperty.Register ( 
"MyString", 
typeof (string), 
typeof (MyClass), 
new FrameworkPropertyMetadata("Default value")); 


前 面 学 习 了 三 个 回调 方法 ， 分 别 用 于 属性 变更 通知 、 属 性 强制 类 型 转换 和 属性 值 的 验证 。 这 些 回 调 方法 与 
依赖 属性 一 样 ， 都 必须 实现 为 公共 的 静态 方法 。 每 个 回调 方法 都 有 特定 的 返回 值 关 型 和 参数 列表 ， 在 使 用 回调 
方法 时 必须 遵循 。 


现在 ， 继 续 开 发 游戏 客户 新 Karli Cards。 下 面 的 “ 试 一 试 ”练习 将 在 应 用 程序 中 创建 一 个 用 户 控件 来 表示 
纸牌 。 
注意 : 


在 编辑 器 中 输入 propdp 并 按 Tab 键 可 添加 依赖 属性 。 


试 一 试 ”用 户 控件 : KarliCards.GuNCardControl.xaml 


到 之 前 示例 中 的 KarliCards.Gui 项 目 。 

(1) 本 例 将 用 到 第 13 草创 建 的 Ch13CardLib 项 目 ， 因 此 把 它 添 加 到 解决 方案 中 。 首 先 在 解决 方案 资源 管理 夫 
中 右 击 解决 方案 名 称 ， 然 后 选择 Add | Existing Project。 接 下 来 ， 浏 览 到 第 13 章 的 代码 示例 ， 选 择 Ch13CardLib.csproj 
Xf. 

(2) f£ KarliCards.Gui "P Chl3CardLib 项 目的 引用 。 有 具体 做 法 为 : 在 KarliCards.Gui 项 目 中 右 击 
References, it}# Add Reference。 人 然后 从 树 型 视图 的 左 侧 单 击 Projects | Solution， 并 选择 Ch13CardLib， 最 后 单 
击 OK 按钮 。 

(3) 在 KarliCards.Gui 项 目 中 添加 一 个 新 类 ,从 而 实现 添加 一 个 新 的 值 转换 费 , 命 名 为 RankNameConverter.cs, 
添加 如 下 代码 : 

using System; 

using System.Windows; 

using System.Windows.Data; 


namespace KarliCards.Gui 


{ 
[ValueConversion (typeof (Chl3CardLib.Rank), typeof (string) ) ] 
public class RankNameConverter : IValueConverter 


{ 
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public object Convert (object value, Type targetType, 
object parameter, System.Globalization.CultureInfo culture) 
{ 
int source = (int)value; 
if (source == || source > 10) 
{ 
Switch (source) 
{ 
case 1: 
return "Ace"; 
case 11: 
return "Jack"; 
case 12: 
return "Queen"; 
case 13: 
return "King"; 
default: 
return DependencyProperty.UnsetValue; 
} 
} 
else 
return source.ToString(); 
} 
public object ConvertBack (object value, Type targetType, 
object parameter, System.Globalization.CultureInfo culture) 
{ 
return DependencyProperty.UnsetValue; 
} 
} 
} 


(4) f£ KarliCards.Gui Jii H "P JH FH Pe CardControl. 
(5) ix E UserControl 的 Height. Width 和 Name 属性 ， 如 下 所 示 : 


Height-"154" Width="100" Name-"UserControl" 
(6) 在 Grid 控件 之 前 ， 添 加 在 该 控件 的 定义 中 要 使 用 的 资源 : 


<UserControl.Resources> 
<local:RankNameConverter x:Key="rankConverter"/> 
<DataTemplate x:Key-"SuitTemplate"- 
<TextBlock Text="{Binding}"/> 
</DataTemplate> 
«Style TargetType-"Image" x:Key="SuitImage"> 
<Style.Triggers> 
<DataTrigger Binding="{Binding ElementName=UserControl, Path=Suit}" 
Value="Club"> 
«Setter Property-"Source" Value="Images\Clubs.png" /> 
</DataTrigger> 
<DataTrigger Binding="{Binding ElementName-UserControl, Path=Suit}" 
Value="Heart"> 
«Setter Property-"Source" Value="Images\Hearts.png" /> 
</DataTrigger> 
«DataTrigger Binding="{Binding ElementName-UserControl, Path=Suit}" 
Value-"Diamond"- 
«Setter Property-"Source" Value="Images\Diamonds.png" /> 
</DataTrigger> 
<DataTrigger Binding="{Binding ElementName-UserControl, Path=Suit}" 
Value="Spade"> 
«Setter Property-"Source" Value="Images\Spades.png" /> 
</DataTrigger> 
</Style.Triggers> 
</Style> 
«/UserControl.Resources- 


(7) 在 Grid 控件 内 部 , 添加 Rectangle 控件 ， 如 下 所 JR: 


«Rectangle RadiusX-"12.5" RadiusY-"12.5"» 
<Rectangle.Fill> 
<LinearGradientBrush EndPoint="0.47,-0.167" StartPoint="0.86,0.92"> 
<GradientStop Color="#FFDIC78F" Offset-"0"/» 
<GradientStop Color="#FFFFFFFF" Offset="1"/> 
</LinearGradientBrush> 
</Rectangle.Fill> 
<Rectangle.Effect> 
<DropShadowEffect Direction-"145" BlurRadius-"10" ShadowDepth="0" /> 
«/Rectangle.Effect- 
</Rectangle> 
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(8) 接 下 来 添加 Path 控件 。 添 加 完毕 后 ， 应 该 会 看 到 如 图 15-1 所 示 的 控件 。 


«Path Fill-"£FFFFFFFF" Stretch-"Fill" Stroke="{x:Null}" 
Margin-" 0,0,35,0" Data="M12,0 
L47,0 
CIB,25 17,81 23,58 
35,131 54,144 63,149 
L12,149 
C3,149 0,143 0,136 
L0, 12 
CO,5 3,0 12,0 
a> 
<Path.OpacityMask> 
<LinearGradientBrush EndPoint="0.957,1.127" StartPoint="0,-0.06"> 
<GradientStop Color="#FF000000" Offset="0"/> 
<GradientStop Color="#00FFFFFF" Offset="1"/> 
</LinearGradientBrush> 
</Path.OpacityMask> 
</Path> 


:使 用 一 些 标签 来 显示 纸 


(9) 现在 可 以 看 到 纸牌 背面 的 显示 ， 但 我 们 也 希望 控制 纸牌 正面 的 显示 ， 所 以 继 竹 
牌 的 花色 和 有 牌 面 大 小 。 


<Label x:Name="SuitLabel" 
Content="{Binding Path=Suit, ElementName=UserControl, Mode=Default}" 
ContentTemplate="{DynamicResource SuitTemplate}" 
HorizontalAlignment-"Center" VerticalAlignment-"Center" 
Margin-"8,51,8,60" /> 

«Label x:Name-"RankLabel" Grid.ZIndex-"1" 
Content="{Binding Path-Rank, ElementName-UserControl, Mode=Default, 

Converter={StaticResource ResourceKey-rankConverter]]" 

ContentTemplate="{DynamicResource SuitTemplate]" 
HorizontalAlignment-"Left" VerticalAlignment-"Top" 
Margin-"8,8,0,0" /> 

«Label x:Name-"RankLabelInverted" 
Content="{Binding Path-Rank, ElementName-UserControl, Mode-Default, 

Converter={StaticResource ResourceKey-rankConverter]]" 
ContentTemplate="{DynamicResource SuitTemplate}" 
HorizontalAlignment-"Right" VerticalAlignment-"Bottom" 
Margin-"0,0,8,8" RenderTransformOrigin="0.5,0.5"> 
<Label .RenderTransform> 
<RotateTransform Angle-"180"/» 

«/Label.RenderTransform- 

</Label> 


(10) 最 后 ， 图 片 将 显示 纸牌 的 化 色 ， 花 色 的 显示 应 该 具有 美观 的 可 视 化 外 观 。 


«Image Name="TopRightImage" Style="{StaticResource ResourceKey-SuitImage]" 
Margin="12,12,8,0" HorizontalAlignment-"Right" VerticalAlignment-"Top" 
Width-"18.5" Height-"18.5" Stretch-"UniformToFill" /> 

«Image Name-"BottomLeftImage" Style="{StaticResource ResourceKey=SuitImage}" 
Margin-"12,0,8,12" HorizontalAlignment-"Left" VerticalAlignment-"Bottom" 
Width-"18.5" Height-"18.5" Stretch-"UniformToFill" 
RenderTransformorigin="0.5,0.5"> 

«Image.RenderTransform- 
<RotateTransform Angle-"180" /> 
«/Image.RenderTransftorm- 
</Image> 


(11) 在 Card Control 的 代码 隐藏 文件 中 ， 给 该 类 添加 3 个 依赖 属性 (可 输入 propdp 并 按 Tab 键 两 次 ， 利 用 
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Visual Studio 为 这 些 属性 创建 模板 ): 


public static DependencyProperty SuitProperty 
"mur", 
typeof (Chl3CardLib.Suit), 
typeof (CardControl), 
new PropertyMetadata(chl3CardLib.Suit.Club, 
new PropertyChangedCallback (OnSuitChanged) )); 
public static DependencyProperty RankProperty - DependencyProperty.Register( 
"Rank", 
typeof (Chl3CardLib.Rank), 
typeof (CardControl), 
new PropertyMetadata (Chl3CardLib.Rank.Ace)); 
public static DependencyProperty IsFaceUpProperty = DependencyProperty.Register ( 
"IsFaceUp", 
typeof (bool), 
typeof (CardControl), 
new PropertyMetadata (true, new PropertyChangedCallback (OnIsFaceUpChanged))); 
public bool IsFaceUp 
{ 
get { return (bool)GetValue(IsFaceUpProperty); } 
set { SetValue (IsFaceUpProperty, value); } 
} 
public Chl3CardLib.Suit Suit 
{ 
get { return (Chl3CardLib.Suit)GetValue(SuitProperty); } 
set { SetValue(SuitProperty, value); } 
} 
public Chl13CardLib.Rank Rank 
{ 
get { return (Chl3CardLib.Rank)GetValue (RankProperty); } 
set { SetValue(RankProperty, value); } 
} 


(12) 在 该 关中 添加 更 改 事件 处 理 程序 : 


public static void OnSuitChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs args) 

{ 
var control = source as CardControl; 
control.SetTextColor(); 

} 

private static void OnIsFaceUpChanged (DependencyObject source, 

DependencyPropertyChangedEventArgs args) 


DependencyProperty.Register ( 


{ 
var control = source as CardControl; 
control.RankLabel.Visibility = control.SuitLabel.Visibility = 
control.RankLabelInverted.Visibility = 
control.TopRightImage.Visibility = 
control.BottomLeftImage.Visibility = control.IsFaceUp ? 
Visibility.Visible : Visibility.Hidden; 
} 


(13) 在 该 类 中 添加 如 下 属性 : 


private Chl3CardLib.Card card; 
public Chl13CardLib.Card Card 
{ 
get { return card; } 
private set { card = value; Suit = card.suit; Rank = card.rank; } 


} 
(14) ABI PTA, Ue ABI, ERREN R: 


public CardControl(Chl3CardLib.Card card) 
{ 
InitializeComponent (); 
Card = card; 
} 
private void SetTextColor () 
{ 
var color = (Suit == Chl3CardLib.Suit.Club || Suit == Chl3CardLib.Suit.Spade) 
new SolidColorBrush(Color.FromRgb(0, 0, 0)) : 
new SolidColorBrush(Color.FromRgb(255, 0, 0)); 
RankLabel.Foreground - SuitLabel.Foreground - RankLabelInverted.Foreground - 
color; 


"J 
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(15) 定位 到 GameClientWindow， 将 一 个 新 网 格 添加 到 该 标签 下 方 的 窗口 中 : 


«Grid x:Name-"contentGrid" Grid.Row-"2" /> 


(16) 将 主 网 格 的 Background MAK B NEEE: 


<Grid Background="Green"> 


(17) 打开 代码 隐藏 文件 ， 修 改 构造 函数 ， 如 下 所 示 : 


public GameClientWindow () 
{ 
InitializeComponent (); 
var position = new Point(15, 15); 
for (var i = 0; 1 < 4; i++) 
{ 
var suit = (Chl3CardLib.Suit)i:; 
position.Y = 15; 
for (int rank = 1; rank < 14; rank++) 
{ 
position.Y += 30; 
Var card = new CardControl (new Chl3CardLib.Card( (Ch13CardLib.Suit) suit, 
(Ch13CardLib.Rank) rank) ); 
card.VerticalAlignment = VerticalAlignment.Top; 
card.HorizontalAlignment = HorizontalAlignment.Left; 
card.Margin = new Thickness (position.X, position.Y, 0, 0); 
contentGrid.Children.Add (card); 
} 
position.X += 112; 
} 
} 


(18) 运行 该 应 用 程序 ， 结 果 如 图 15-2 所 示 。 


B ' Karli Cards Game Client 


wrox Programmer to Prog........... Karli Cards 


15-2 
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示例 说 明 

本 例 创 建 了 一 个 用 户 控件 ,， 它 市 两 个 依赖 属性 ， 并 包含 使 用 该 控件 的 客户 只 代码 。 该 示例 通 闵 了 很 多 内 容 ， 
FHA Card 控件 的 代码 开始 介绍 。 

Card 控件 包含 的 大 多 数 代 码 类 似 于 本 章 前 面 介绍 的 代码 。 第 一 部 分 定义 了 该 控件 的 一 些 资产。 首先， 定义 
了 RankConverter 类 的 一 个 实例 ， 确 保 在 XAML 中 能 够 使 用 它 。 

<local:RankNameConverter x:Key="rankConverter"/> 

接 下 来 定义 了 DataTemplate, 它 类 似 于 ControlTemplate, 可 用 于 修改 控件 的 可 视 化 外 观 . 不 过 ControlTemplate 
通 贡 仅 用 于 修改 控件 的 外 观 ， 而 DataTemplate 还 可 用 于 呈现 控件 的 辰 层 数 据 ， 例 如 ， 可 使 用 DataTemplate 来 显 
示 DataContext 控件 的 属性 。 

最 后 所 定义 的 资源 是 Image 控件 的 样式 。 该 样式 定义 了 4 个 触发 器 ,其 中 每 个 触发 器 都 与 UserControl 类 的 
Suit 属性 相 绑 定 。 触 发 器 根据 Image 控件 的 值 的 不 同 ， 将 Source 属性 设置 为 相应 的 图 片 。 

«DataTrigger Binding-"[Binding ElementName-UserControl, Path=Suit}" 

Value="Club"> 
«Setter Property-"Source" Value="Images\Clubs.png" /> 

</DataTrigger> 

定义 完 Card 控件 的 资源 后 ， 下 面 开 始 纸牌 的 绘制 。 所 绘制 纸牌 的 网 格 中 的 第 一 个 控件 是 Rectangle, IXA 
平和 有 些 令 人 惊讶 ， 因 为 纸牌 的 四 角 部 是 圆 角 。 通 过 设置 该 控件 的 RadiusX 和 RadiusY 属性 可 以 完成 这 一 操作 : 

«Rectangle RadiusX-"12.5" Radiusy="12.5"> 

iX PA Je E Si Bas rb AT ee EB ELE] x A y 半径， 矩形 在 内 部 使 用 该 椭圆 来 显示 圆 角 。 

之 后 ， 使 用 LiniarGradientBrush AE KHAAA. StartPoint 和 EndPoint 属性 表示 所 绘制 的 一 条 倾斜 的 直 
线 。 默 认 情 况 下 ， 这 条 直线 的 位 置 从 0,0( 左 上 角 ) 到 1,1( 右 下 角 )。 在 此 指定 直线 从 右 下 角 开 始 倾 斜 ， 到 控件 项 部 
I x friget: 

«LinearGradientBrush EndPoint-"0.47,-0.167" StartPoint="0.86,0.92"> 

Anu. EJEN DropShadow 效果 ， 在 控件 的 周围 绘制 阴影 。 

接 下 来 , 将 Path 控件 放 入 Grid 中 ，Path 控件 允许 使 用 直线 和 曲线 绘制 多 边 形 。 
可 以 使 用 C#i 咎 言 对 该 控件 将 摘 述 的 路 径 进行 编码 , 也 可 以 在 该 示例 中 使 用 标记 语法 
来 实现 。 因 为 Path 是 为 控件 定义 的 ， 所 以 可 能 难以 看 到 所 绘制 的 多 边 形 。 这 是 因为 
Stroke 属性 的 值 为 null， 为 解释 这 一 点 ， 试 看 将 它 的 值 修改 为 Red。 之 后 应 该 在 纸牌 
上 能 看 到 图 15-3 所 示 的 多 边 形 。 

Stretch 属性 也 非常 重要 ,将 其 设置 为 Fil 时， 如果 包 含 Path 的 控件 的 大 小 发 生 
变化 ， 多 边 形 也 会 随 之 调整 大 小 。 最 后 ，Margin 属性 使 Path 控件 的 右边 缘 移 动 到 距 


离 父 控件 右边 缘 的 左 侧 35 像素 处 。 图 15-3 
现在 看 一 下 Data STE: 
Data="M12,0 
L47,0 


C18,25 17,81 23,98 
35,131 54,144 63,149 
L12,149 

C3,149 0,143 0,136 
LO, 12 

C0,5 3,0 12,0 

z;" 


Data 属性 用 来 设置 路 径 。 该 属性 的 值 是 一 个 格 云 十 分 特殊 的 字符 串 。 字 符 串 中 的 一 些 数字 前 面市 有 字母 前 
缀 ， 而 一 些 数字 前 面 不 带 前 缀 ， 下 面 进 一 步 介 绍 。 

路 径 以 M12.0 开始 。 其 中 坐标 之 前 的 M 表示 该 路 径 的 起 点 ， 这 里 的 M 大 与 非 营 重要 ， 表 示 该 坐标 是 一 个 
绝对 位 置 ， 夺 为 小 写 的 m， 则 表示 该 坐标 是 一 个 相对 于 前 一 个 点 的 偏 移 量 。 如 果 不 存 在 这 样 一 个 后 ， 则 上 一 个 
RNA irae 0,0。 这 将 多 边 形 的 起 后 置 于 左上 角 左 侧 12 像素 处 。 

下 一 个 指令 是 L47,0， 表 示 要 创建 一 条 从 当前 点 到 指定 点 的 直线 。 在 本 示例 中 ， 绘 制 了 一 条 从 12,0 到 47,0 
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的 垂直 线 。 编 写 指 令 h35 Ek H47 也 可 实现 这 种 效果 。 字 母 了 HH， 无 论 是 大 写 还 是 小 写 都 可 表示 要 绘制 的 路 径 是 一 
条 垩 直线 。 同 样 ， 这 里 的 大 写字 母 表示 是 绝对 位 置 ， 小 写字 母 表示 相对 于 上 一 个 点 的 距离 。 


第 3 个 指令 有 氮 长 : 


C18,25 17,81 23,98 


其 中 的 C 表示 所 绘制 的 是 一 条 Cubic Bezier 曲线 。 为 此 ， 需 要 四 个 点 : 起 点 、 两 个 指定 起 点 和 终点 切 


线 的 皮 、 终 点 。 起 反 为 上 一 条 线 的 终点 。 前 两 个 点 是 控制 点 ， 分 别 定义 曲线 的 起 点 和 终点 切线 。 第 3 个 后 
星 终 占 
FEST Io 


接 下 来 的 一 条 指令 数字 前 面 没有 前 组 字母 ， 这 表示 该 指令 的 类 型 同上 一 条 指令 ， 这 里 表示 是 另 一 条 曲线 。 

余下 的 指令 只 是 绘制 更 多 的 线条 和 曲线 ， 直 到 最 后 遇 到 小 写字 母 z。 这 意味 看 必须 闭合 该 多 边 形 ， 所 以 将 
从 当前 位 置 朝 同 起 点 绘制 一 条 直线。 在 本 例 中 ， 可 以 省 略 这 个 小 写字 母 z， 因 为 最 后 一 条 曲线 与 多 边 形 的 起 点 
汇合 到 了 一 起 ， 但 是 为 了 完整 起 见 ， 我 们 还 是 把 它 包 含 了 进来 。 

CardControl 控件 的 代码 回 客 户 问 代码 提供 了 三 个 依赖 属性 ， 即 Suit. Rank 和 IsFaceUp， 并 将 它们 与 控件 
布局 中 的 可 视 化 元 素 绑 定 起 来 。 结 果 ， 将 Suit 设置 为 Club( 梅 伦 ) 时 ， 牌 面 中 央 会 显示 Club 文字 ， 右 上 角 和 左下 
A NEA. FE, Rank 的 值 ( 牌 面 的 大 小 ) 也 显示 在 其 余 两 个 角 上 。 

稍 后 介绍 这 些 属 性 的 实现 代码 。 现 在 上 只 需要 知道 它们 者 是 第 10 章 建立 的 CardLib 项 目 中 的 枚 举 。 

三 个 标签 显示 了 牌 面 大 小 和 人 花色。 尽管 它们 与 不 同属 性 绑 定 起 来 ， 但 有 一 些 共同 之 处 。 它 们 必须 根据 所 绑 
定 的 属性 值 显示 红字 或 黑 字 。 在 本 例 中 ， 牌 面 赢 色 是 使 用 Rank 友 生 变化 时 触 友 的 事件 来 设置 的 ， 也 可 以 像 下 
Tío FE ASE FH fiU i: 

«Label x:Name="SuitLabel" 

Content-"[Binding Path-Suit, ElementName-UserControl, Mode=Default}" 


ContentTemplate="{DynamicResource SuitTemplate}" HorizontalAlignment-"Center" 
VerticalAlignment-"Center" Margin-"8,51,8,60" /> 


绑 定 属性 值 时 ， 也 可 以 指定 如 何 显 示 绑 定 的 内 容 ， 这 是 通过 数据 模板 (data template) 来 实现 的 。 在 本 例 中 ， 
数据 模板 就 是 引用 为 动态 资源 的 SuitTemplate( 不 过 ， 这 里 也 可 以 使 用 静态 资源 绑 定 )。 该 模板 在 用 户 控件 资源 部 
分 进行 定义 : 

<UserControl.Resources> 
<DataTemplate x:Key="SuitTemplate"> 
<TextBlock Text="{Binding}"/> 


</DataTemplate> 
«/UserControl.Resources- 


Suit 的 字符 串 值 用 作 TextBlock 控件 的 Text 属性 。 这 个 DataTemplate XE X. TE PSS e Il X /] vb s FS f HH 
To Sut 是 一 个 枚 举 值 ， 其 中 每 一 项 的 名 称 都 会 目 动 转 换 为 字符 串 ， 显 示 在 Text 属性 中 。 
两 个 Rank 标签 在 绑 定 中 包含 一 个 值 转换 器 。 
«Label x:Name-"RankLabel" Grid.ZIndex="1" 
Content="{Binding Path-Rank, ElementName-UserControl, Mode-Default, 
Converter-[StaticResource ResourceKey=rankConverter}}" 
ContentTemplate="{DynamicResource SuitTemplate}" 


HorizontalAlignment="Left" VerticalAlignment="Top" 
Margin="8,8,0,0" /> 


AR Pear F E 8] 8157 TE UserControl 资源 中 : 

«local:RankNameConverter x:Key="rankConverter"/> 

如 果 删 除 该 值 转换 器 ， 并 不 会 破坏 控件 。 仍 可 以 看 到 Ace. 2. 3. 4 等 枚 举 值 。 枚 举 值 的 名 称 也 会 转换 为 
字符 串 一 -Ace、Deuce、Three、Four 等 。 尽 管 这 在 技术 上 是 正确 的 ， 但 并 不 完全 合 规 ， 因 此 需要 将 值 转换 为 数 
字 和 字符 串 的 组 合 。 

最 后 需要 注意 的 是 RankLabel 中 的 Grid.ZIndex="1" 属 性 。 在 Grid 或 Canvas 中 , 控件 的 ZIndex 属性 确定 该 
控件 在 众多 控件 堆 著 中 的 层级 。 如 果 两 个 或 多 个 控件 位 于 同一 位 置 , 就 可 以 用 ZIndex 强制 其 中 一 个 控件 排 在 最 
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前 面 。 一 般 而 言 ， 所 有 控件 的 Zindex 属性 都 为 0， 因 此 将 某 个 控件 的 该 属性 设置 为 1， 可 使 它 排 在 最 前 面 。 这 
是 必要 的 ， 因 为 控件 之 间 的 遮挡 会 掩 新 挥 控件 上 的 文学 。 


要 让 上 述 数 据 绑 定 正 常 工作 ， 必 须 使 用 前 一 市 介绍 的 技术 定义 三 个 依赖 属性 。 它 们 在 用 尸 控件 的 代码 隐 乱 
文件 中 定义 (它们 都 有 简单 的 .NET 属性 封 沪 妖 ， 但 由 于 太 过 简单 ， 此 处 未 包含 ): 


public static DependencyProperty SuitProperty = DependencyProperty.Register ( 
"suit", 
typeof (CardLib.Suit), 
typeof (CardControl), 
new PropertyMetadata (CardLib.Suit.Club, 
new PropertyChangedCallback (OnSuitChanged) )); 
public static DependencyProperty RankProperty = DependencyProperty.Register ( 
"Rank", 
typeof (CardLib.Rank), 
typeof (CardControl), 
new PropertyMetadata (CardLib.Rank.Ace) ); 
public static DependencyProperty IsFaceUpProperty = DependencyProperty.Register ( 
“IsFaceUp", typeof (bool), 
typeof (CardControl), 
new PropertyMetadata (true, new PropertyChangedCallback (OnIsFaceUpChanged) )); 


依赖 属性 使 用 回调 方法 来 验证 其 值 ，Suit 和 IsFaceUp 属性 也 为 其 值 的 更 改 准备 好 了 回调 方法 。 

当 Suit 的 值 改 变 时 ， 就 调用 OnSuitChangedO 回 调 方法 。 该 方法 将 文本 的 颜色 设置 为 红色 ( 红 桃 和 方块 或 黑 
色 ( 梅 花 或 黑 桃 )。 为 此 ， 要 在 方法 调用 的 源 代 码 中 调用 一 个 实用 方法 。 这 是 必 不 可 少 的 ， 因 为 回调 方法 实现 为 
静态 方法 ， 但 它 会 将 触 上 友 事 件 的 用 户 控件 实例 传递 为 一 个 参数 ， 以 产生 交互 。 所 调用 的 方法 是 SetTextColorO: 

public static void OnsuitChanged (Dependencyobject source, 
DependencyPropertyChangedEventArgs args) 

= control = source as CardControl; 
control.SetTextColor(); 

} 

SetTextColor0 方 法 是 私有 的 ,但 显然 OnSuitChangedQ TVA Ey; np, AAS EET ae Se A B S 
方法 ， 但 它们 是 同一 个 类 的 成 员 。SetTextColor0 只 是 将 控件 中 各 个 标签 的 Foreground 属性 设置 为 纯色 画笔 ， 而 
具体 闫 色 取 决 于 Suit 的 值 ， 为 红色 或 黑色 。 

当 IsFaceUp 改变 时 ， 该 控件 会 显示 或 隐藏 用 来 显示 控件 当前 值 的 图 片 和 标 釜 。 

GameClientWindow.xaml.cs 代码 隐 闫 文 件 中 的 代码 仅 是 临时 用 来 显示 纸牌 的 。 它们 为 每 种 花色 的 13 IKE 
成 脾 面 ， 并 将 相同 的 花色 排 在 一 列 。 


15.3 EL 


该 应 用 程序 的 主 窗口 是 玩 游戏 时 的 主 界面 ， 而 现在 其 中 还 没有 太 多 控件 。 本 节 将 开发 这 个 话 戏 ， 但 在 开始 
之 前 ， 还 必须 做 三 件 事 。 自 先 给 游戏 客 尸 问 窗 口 添加 亲 蛙 ， 之 后 将 已 构建 好 的 窗口 与 末 单 项 绑 定 起 来 。 


15.3.1 菜单 控件 


大 多 数 应 用 程序 都 包含 某 交 来 单 和 工具 栏 。 它 们 的 目的 是 相同 的 : 让 用 户 轻 松 地 浏览 应 用 程序 的 内 容 。 工 
县 柱 通 稼 包含 集 单 所 提供 的 相同 集 单 项 的 子 集 ， 可 将 其 视 为 菜单 项 的 快捷 方式 。 

Visual Studio 内 置 了 Menu 和 Toolbar 控件 。 下 面 将 介绍 Menu 控件 的 用 法 ，Toolbar T2TFIT] FRIES HIE 
类 似 。 

默认 情况 下 ， 有 六 时 项 显示 为 水 平 的 一 栏 ， 每 个 羔 单项 都 可 以 展开 其 下 拉 亲 单 。 亲 单 是 Item 控件 ， 所 以 ， 可 
修改 其 包含 的 默认 内 容 ， 不 过 ， 一 般 使 用 某 种 形式 的 MenuItem( 荣 单项 )， 如 下 例 所 示 。 每 个 Menultem 都 可 以 
包含 其 他 沫 单项 ， 将 Menultem 骨 套 起 来 ， 就 可 以 建立 复杂 的 淋 单 ， 但 应 使 沫 单 结构 尽 可 能 简洁 。 
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使 用 一 些 属性 ， 可 以 控制 Menultem 控件 的 显示 方式 ( 见 表 15-3). 


表 15-3 Menultem 的 显示 属性 


属 性 说 明 
Icon 在 控件 的 左 侧 显 示 一 个 小 图 标 
IsCheckable 在 控件 的 左 侧 显示 一 个 CheckBox 控件 
IsChecked 获取 或 设置 Menultem 上 的 CheckBox 值 


15.3.2 ”路 由 命令 和 菜单 


路 由 命令 (routed command) 在 第 14 草 中 简单 介绍 过 ， 现 在 将 第 一 次 用 到 它 。 路 由 命令 与 事件 类 似 ， 都 是 在 
用 尸 执 行 攻 个 操作 时 执行 代码 ， 都 可 以 返回 茶 个 状态 ， 表 示 它 们 在 任何 给 定时 间 是 人 否 可 以 执行 。 

为 什么 使 用 路 由 命令 而 不 使 用 事件 ， 至 少 有 三 个 理由 : 

(1) 在 应 用 程序 的 多 个 不 同位 置 触 友 杀 个 事件 的 操作 。 

(2) UI 元 系 应 只 在 特定 条 件 下 才 可 用 ， 例 如 在 没有 内 容 需 要 保存 时 ，Save 按钮 束 应 该 禁用 。 

(3) 希望 断 开 处 理事 件 的 代码 和 代码 隐 嘎 文件 的 联系 。 

如 果 出 现 上 述 几 种 情况 ， 就 可 以 考虑 使 用 路 由 命令 。 对 于 本 章 开 发 的 游戏 ， 某 些 菜单 项 也 应 能 通过 工具 栏 
来 执行 。 还 有 ，Save 操作 应 只 在 游戏 过 程 中 可 用 ， 且 应 在 菜单 和 工具 栏 中 都 可 用 。 


注意 : 

重要 的 是 ， 只 有 在 KarliCards GUI 项 目 中 正确 设置 了 默认 名 称 空 间 ， 才 能 使 示例 工作 。 如 果 出 现 了 编译 器 
错误 ， 指 出 类 或 资源 不 是 名 称 空 间 的 成 员 ， 就 可 能 使 用 了 与 本 书 不 同 的 名 称 空 间 。KarliCards HAA RIEA T 
两 个 根 名 称 空 间 : 用 于 Chl3CardLib 项 目的 Ch13CardLib 和 用 于 KarliCards GUI 项 目的 KarliCards.Gui。 如 果 出 
了 问题 ， 就 尝试 在 整个 项 目 中 改变 名 称 空 间 ， 来 匹配 本 书 使 用 的 那些 名 称 空间 。 


试 一 试 ”创建 主 窗口 : KarliCards.Gui\GameClientWindow.xaml 


本 例 将 继续 处 理 本 章 之 前 已 创建 好 的 GameClientWindow. 
(1) 打开 ControlResource.xaml 文件 ， 添 加 Menu 控件 所 要 使 用 的 样式 : 


«Style x:Key-"MainMenuStyle" TargetType="Menu"> 
«Setter Property-"Background" Value-"Black" /> 
«Setter Property-"Foreground" Value-"White" /> 
«Setter Property-"FontWeight" Value-"Bold" /> 

«/Style- 

«Style x:Key-"MainMenuItemStyle" TargetType-"MenuItem"- 
«Setter Property-"Foreground" Value-"White" /> 

</Style> 

«Style x:Key="MainMenuSubMenultemStyle" TargetType="MenulItem"> 
«Setter Property-"Foreground" Value-"Black" /> 
«Setter Property-"Width" Value-"200" /» 
«Setter Property-"Height" Value-"22" /> 

«/Style- 

«Style x:Key-"MenuItemSeperatorStyle" TargetType-"Separator"- 
«Setter Property-"Foreground" Value-"Black" /> 

</Style> 


(2) 打开 GameClientWindow, 4 Menu 控件 拖 放 到 网 格 中 。 设 置 如 下 属性 : 


<Menu Grid.Row="1" Margin="0" Style="{StaticResource MainMenuStyle}"> 
<Menu> 


(3) 在 设计 视图 中 石 击 该 Menu 控件 ， 并 选择 Add Menultem 命令 。 
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(4) 将 Header 属性 改 为 ”File”。 注意 单词 前 面 要 加 一 个 下 男 线 。 删 除 Height 和 Width 属性 并 设置 Style 为 


MainMenustyle: 
<MenuItem Header-" File" Style="{StaticResource MainMenuItemstyle]"/» 


(5) 在 File 项 中 再 添加 一 个 MenuItem， 做 法 是 右 击 File 项 ， 然 后 选择 Add Menultem 命令 。 设 置 其 Header 


«MenulItem Header=" File" Style="{StaticResource MainMenuItemstyle]"- 
«MenuItem Header-" New Game" Style="{StaticResource 
MainMenuSubMenultemStyle}"/> 
« /MenulItem- 


(6) 将 下 列 Menultem i257 Fl File 3252: 


«MenuItem Header-" Open" Style="{StaticResource 
MainMenusubMenuItemstyle]"/» 

<Menultem Header-" Save" Style="{StaticResource 
MainMenuSubMenultemStyle}" Command="Save"> 
«MenuItem.Icon- 

«Image Source="Images\base floppydisk 32.png" Width-"20" /> 

«/MenuItem.Icon- 

</Menultem> 

«Separator Style="{StaticResource MenultemSeperatorstyle}"/> 


«MenulItem Header=" Close" 
Style="{StaticResource MainMenuSubMenultemStyle}" Command="Close"/> 


(7) 在 File 菜单 项 的 同一 级 别 添加 以 下 Menultem 控件 : 


«MenuItem Header-" Game" Style="{StaticResource MainMenulItemStyle}"> 
<Menultem Header-" Undo" Style="{StaticResource 
MainMenuSubMenuItemstyle]"/» 


«/MenulItem- 
<Menultem Header-" Tools" Style="{StaticResource MainMenuItemstyle]"- 
xMenuItem Header-" Options" Style="{StaticResource 
MainMenusubMenuItemstyle]"/» 
«/MenuItem- 
«MenuItem Header-"Help" Style="{StaticResource MainMenuItemstyle]"- 
«MenuItem Header-" About" Style-"[StaticResource 

MainMenuSubMenultemStyle}"/> 

«/MenuItem- 


(8) 在 主 网 格 控 件 之 前 ，</Window.Resources> 标 签 之 后 ， 将 以 下 命令 绑 定 添加 到 窗口 中 : 


<Window.CommandBindings> 
<CommandBinding Command-"ApplicationCommands.Close" 
CanExecute-"CommandCanExecute" EXxecuted-"CommandExecuted" /> 
<CommandBinding Command="ApplicationCommands.Save" 
CanExecute-"cCommandCanExecute" Executed-"commandExecuted" /> 


«/Window.CommandBindings- 


(9) 现在 窗口 应 该 如 图 15-4 所 示 。 
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wrok Froframmer to Proarammer™ Karli Cards 


File Game Tools Help 


图 15-4 


(9) 打开 GameClientWindow.xaml.cs (UPS hae OCT E, WIN RPA ITA. —iE ELA System.Windows Input 
名 称 空 间 : 


private void CommandCanExecute (object sender, CanExecuteRoutedEventArgs e) 


{ 
if (e.Command == ApplicationCommands.Close) 
e.CanExecute = true; 
if (e.Command == ApplicationCommands. Save) 
e.CanExecute = false; 
e.Handled = true; 
} 
private void CommandExecuted (object sender, ExecutedRoutedEventArgs e) 
{ 
if (e.Command == ApplicationCommands.Close) 
this.Close():; 
e.Handled = true; 
] 


(10) 修改 GameClientWindow 的 构造 函数 ， 使 它 仅 调用 InitializeComponent(): 


public GameClientWindow () 
{ 


(11) 运行 该 应 用 程序 。 


InitializeComponent (); 


示例 说 明 

运行 这 个 应 用 程序 时 ，Game Client 窗口 一 开始 会 最 大 化 显示 ， 且 仍 可 以 根据 需要 调整 其 大 小 。 按 住 Alt 刍 
时 ，File 菜单 会 获得 焦点 ，F 字母 也 会 加 上 下 画 线 ， 说 明 可 以 按 F 键 展开 该 菜单 。 

展开 菜单 后 ，Save 菜单 处 于 禁用 状态 ， 但 该 菜单 会 显示 一 个 磁盘 图 标 ， 在 元 素 标题 的 右边 会 显示 “Cti+S” 
标注 。 这 表示 可 按 Ctrlts 快捷 键 来 访问 该 菜单 ( 当 其 可 用 时 )。 前 面 没 有 设置 任何 快捷 键 ， 为 什么 会 有 这 样 一 个 
标注 ? 实际 上 ， 为 该 菜单 项 设置 命令 的 代码 如 下 ; 


«MenuItem Header-" Save" Style="{StaticResource MainMenusubMenuItemstyle}" 
Command="Save"> 


这 个 Save 命令 由 WPF 定义 。File 3252 FIN Save 和 Close 菜单 项 是 在 ApplicationCommands 类 中 定义 的 ， 
它 还 定义 了 Cut、Copy、Paste 和 Print 菜单 项 。 为 Menultem 指定 Save 命令 时 ， 快 捷 键 Ctrl+Ss 就 会 分 配给 这 个 
KAM, AAR Bt Windows 应 用 程序 都 使 用 这 个 标准 组 合 键 来 访问 这 个 功能 。 
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ATi Er l y r 一 -| à NEC - TF 4, 大 一 | Lu gp = - thin J 
在 代码 隐藏 文件 中 添加 了 两 个 方法 ， 用 于 确定 命令 的 状态 及 执行 的 操作 。 在 XAML 中 ,创建 了 两 个 命令 绑 
定 ， 来 使 用 此 类 方法 : 
<Window.CommandBindings> 
<CommandBinding Command-"ApplicationCommands.Close" 
CanExecute-"CommandCanExecute" Executed="CommandExecuted" /> 
<CommandBinding Command="ApplicationCommands.Save" 
CanEXxecute-"CommandCanExecute" Executed="CommandExecuted" /> 
«/Window.CommandBindings- 
private void CommandCanExecute (object sender, CanExecuteRoutedEventArgs e) 
{ 
if (e.Command == ApplicationCommands.Close) 
e.CanExecute = true; 
if (e.Command == ApplicationCommands. Save) 
e.CanExecute = false; 
e.Handled = true; 
private void CommandExecuted(object sender, ExecutedRoutedEventArgs e) 
if (e.Command == ApplicationCommands.Close) 
this.Close(); 
e.Handled = true; 


} 

命令 绑 定 中 的 CanExecute 部 分 指定 ， 调 用 一 个 方法 来 确定 命令 在 当时 是 否 对 用 户 可 用 。Executed 部 分 指定 ， 
方法 应 在 用 户 激 活命 令 时 调用 。 注 意 ， 这 与 命令 在 何 处 激活 无 关 。 如 果 集 单项 和 按钮 都 包含 了 Save 命令 ， 那 么 
绑 定 对 它们 都 有 效 。 

CommandCanExecute 目前 的 实现 代码 太 过 简单 ,实际 上 应 该 进行 一 些 计 算 ， 以 确定 应 用 程序 是 否 准 备 好 保 
存 数 据 。 因 为 游戏 还 没有 需要 保存 的 内 容 ， 所 以 只 为 Save 命令 返回 false 值 。 为 此 ， 设 置 CanExecuteRouted- 
EventArgs 类 的 e.CanExecute 属性 。 男 一 方面 ，Close 命令 可 以 正常 执行 ， 所 以 给 它 返 回 true. 

CommandExecuted 执行 的 测试 与 CommandCanExecute 相同 。 如 果 硝 定 要 执行 的 命令 是 Close, HUS BI 2 BU 
窗口 。 


15.4 把 所 有 内 容 结合 起 来 


这 个 游戏 目前 已 开发 了 两 个 独 并 的 对 话 杠 、 一 个 纸牌 库 和 一 个 主 窗口 ， 主 窗口 提供 的 空白 区 域 用 来 显示 游 
戏 。 还 有 许多 工作 要 做 ,但 已 经 有 了 基础 的 率 材 ， 可 以 继续 建立 游戏 。CardLib 中 的 类 插 述 了 整个 游戏 的 “ 域 
模型 (domain model)”， 即 游戏 可 以 分 解 成 的 对 象 ， 必须 重 构 它 们 , 使 其 更 好 地 用 于 Windows 应 用 程序 。 接 下 来 ， 
要 编写 游戏 的 “视图 模型 (View Model))”， 这 是 可 以 控制 游戏 显示 的 一 个 类 。 随 后 ， 创 建 男 外 两 个 用 户 控 件 ， 它 
们 使 用 Card 用 户 控 件 可 视 化 地 显示 该 沂 戏 。 最 后 ， 将 它们 全 部 绑 定 起 来 ， 形 成 完整 的 游戏 客户 奖 。 

itm: 

“视图 模型 ”这 个 术语 来 自 WPF 中 一 种 常见 的 设计 模式 : 模型 -视图 -视图 模型 (MVVM)。 这 种 设计 模式 描 

述 了 如 何 将 代码 从 视图 中 分 离 出 来 ， 又 如 何 将 它们 链接 在 一 起 。 尽 管 本 书 未 遵循 这 种 设计 模式 ， 但 游戏 示例 借 
用 了 其 中 的 许多 元 素 ， 例 如 将 视图 模型 从 视图 中 分 离 出 来 。 对 于 这 个 例子 ， 接 下 来 介绍 的 域 模型 是 MVVM 中 
的 “模型 ”部 分 ， 而 已 创建 的 窗口 是 视图 。 


154.1 重 构 域 模型 
如 前 所 述 ， 域 模型 是 描述 游戏 中 所 用 对 象 的 代码 。 目 前 ，CardLib 项 目的 下 列 类 描述 了 游戏 中 的 对 象 : 


e Card 
e Deck 
e Rank 
e Sui 


除 这 些 类 之 外 ， 游 戏 还 需要 Player 和 ComputerPlayer 2$, FRR. Wie BEC Card 和 Deck 类 ， 
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让 它们 更 好 地 用 于 Windows 应 用 程序 。 
这 有 许多 工作 要 做 ， 现 在 就 开始 吧 。 


注意 : 
本 例 没 有 使 用 之 前 章节 中 的 CardClient 类 ， 因 为 控制 台 应 用 程序 和 Windows 应 用 程序 的 差别 十 分 显著 ， 可 
以 重复 使 用 的 代码 非常 少 。 


试 一 试 ”完成 域 模 型 : KarliCards.Gui 


本 例 继续 上 一 个 练习 的 内 容 。 
(1) 在 游戏 过 程 中 ， 每 个 玩家 都 会 有 不 同 的 “状态 ”。 可 通过 PlayerState 枚 举 对 其 建 模 。 打 开 Ch13CardLib 
项 目 ， 在 项 目 中 新 建 PlayerState 枚 举 。 只 需要 新 建 一 个 类 并 和 蔡 换 代码 ， 如 下 所 示 : 


[Serializable] 
public enum PlayerState 
{ 

Inactive, 

Active, 

MustDiscard, 

Winner, 

Loser 


} 


(2) 接 下 来 为 玩家 新 建 一 些 事 件 。 为 此 ， 需 要 一 些 目 定 义 事件 参数 ， 因 此 添加 另 一 个 类 PlayerEventArgs。 
目前 ， 不 必 担 心 缺 少 Player 25: 


public class PlayerEventArgs : EventArgs 
{ 
public Player Player { get; set; } 
public PlayerState State { get; set; } 
j 


(3) 还 需要 为 纸牌 新 建 一 些 事 件 ， 所 以 新 建 一 个 类 CardEventArgs: 


public class CardEventArgs : EventArgs 
{ 

public Card Card { get; set; } 
} 


(4) FO ComputerSkillLevel 现在 位 于 KarliCards.Gui 项 目的 GameOptions.cs 2 Ff. TELA ZH Pay 
并 移 到 Ch13CardLib 项 目的 相应 文件 中 。 这 会 将 其 名 称 空 间 改 为 Ch13CardLib， 因 此 必须 在 GameOptions. cs 和 
OptionsWindow.xaml.cs 文件 中 添加 Ch13CardLib 名 称 空间 : 


using Chl3CardLib; 


(5) 也 需要 修改 Deck 类 。 这 里 不 是 多 次 返回 本 章 前 面 创建 的 这 个 类 ， 而 是 列 出 其 完整 的 代码 : 


using System; 

using System.Collections.Generic; 
using System. Linq; 

namespace Chl3CardLib 


public delegate void LastCardDrawnHandler (Deck currentDeck); 
public class Deck : ICloneable 
{ 

public event LastCardDrawnHandler LastCardDrawn; 

private Cards cards = new Cards(); 

public Deck () 


InsertAllCards(); 

— Deck(Cards newCards) 
l cards = newCards; 

Spice int CardsInDeck 

{ 


get { return cards.Count; } 
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} 
public Card GetCard(int cardNum) 
{ 
if (cardNum >= 0 && cardNum <= 51) 
{ 
if ((cardNum == 51) && (LastCardDrawn != null)) LastCardDrawn(this); 
return cards[cardNum]; 
} 
else 
throw new CardOutOfRangeException(cards.Clone() as Cards); 
] 
public void Shuffle() 
{ 
Cards newDeck = new Cards(); 
bool[] assigned = new bool[cards.Count]; 
Random sourceGen = new Random(); 
for (int i = 0; 1 < cards.Count; i++) 
{ 
int sourceCard = 0; 
bool foundCard = false; 
while (foundCard == false) 
{ 
sourceCard = sourceGen.Next (cards.Count); 
if (assigned[sourceCard] == false) 
foundCard = true; 
] 
assigned[sourceCard] = true; 
newDeck.Add(cards[sourcecard]); 
} 
newDeck.CopyTo (cards); 
} 
public void ReshuffleDiscarded (List<Card> cardsInPlay) 
{ 
InsertAllCards (cardsInPlay); 
Shuffle (); 
} 
public Card Draw () 
{ 
1f (cards.Count == 0) return null; 
var card = cards[0]: 
cards.RemoveAt (0); 
return card; 
} 
public Card SelectCardofSpecificSuit (Suit suit) 
{ 
Card selectedCard = cards.FirstoOrDefault (card => card?.suit == suit); 
if (selectedCard == null) return Draw(); 
cards .Remove (selectedCard); 
return selectedCard; 
} 
public object Clone () 
{ 
Deck newDeck = new Deck(cards.Clone() as Cards); 
return newDeck; 
} 
private void InsertAllCards () 
{ 


for (int suitVal = 0; suitVal < 4; suitVal++) 


for (int rankVal = 1; rankVal < 14; rankVal++) 
{ 
cards.Add (new Card((Suit)suitVal, (Rank) rankVal)); 
} 
} 
} 
private void InsertAllCards (List<Card> except) 
{ 
for (int suitVal = 0; suitVal < 4; suitVal++) 
{ 
for (int rankVal = 1; rankVal < 14; rankVal++) 
{ 
Var card = new Card((Suit)suitVal, (Rank) rankVal); 
if (except?.Contains (card) ?? false) continue; 
cards .Add (card); 
} 
|] 
} 
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} 
(6) 在 游戏 中 ， 有 两 类 玩家 : Player， 由 真人 来 操作 ; ComputerPlayer， 由 游戏 日 动 控制 。 添 加 Player 25, 
如 下 所 示 : 


using System; 
using System.ComponentModel; 
using System.Linq; 


namespace Chl3CardLib 
{ 
[Serializable] 
public class Player : INotifyPropertyChanged 
{ 
public int Index { get; set; } 
protected Cards Hand { get; set; } 
private string name; 
private PlayerState state; 


public event EventHandler<CardEventArgs> OnCardDiscarded; 
public event EventHandler<PlayerEventArgs> OnPlayerHasWon; 


public PlayerState State 
{ 
get { return state; } 
set 
{ 
state = value; 
OnPropertyChanged (nameof (State) ); 
} 
} 


public virtual string PlayerName 
{ 
get { return name; } 
set 
{ 
name = value; 
OnPropertyChanged (nameof (PlayerName)); 
} 
} 


public void AddCard(Card card) 
{ 
Hand.Add (card); 
if (Hand.Count > 7) 
State = PlayerState.MustDiscard; 
} 


public void DrawCard (Deck deck) 


AddCard (deck.Draw()); 
} 


public void DiscardCard (Card card) 
{ 
Hand. Remove (card) ; 
if (HasWon) 
OnPlayerHasWon?.Invoke(this, new PlayerEventArgs { Player = this, State = 
PlayerState.Winner }); 
OnCardDiscarded?.Invoke(this, new CardEventArgs { Card = card }); 


} 


public void DrawNewHand (Deck deck) 
{ 
Hand = new Cards (); 
for (int i = 0; i < 7; i++) 
Hand.Add (deck.Draw()):; 


public bool HasWon => Hand.Count == 7 && Hand.Select (x => x.suit) 
-Distinct ({) .Count (} == 1; 
public Cards GetCards() => Hand.Clone() as Cards; 


public event PropertyChangedEventHandler PropertyChanged; 
private void OnPropertyChanged (string propertyName) => PropertyChanged? 
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.Invoke(this, new PropertyChangedEventArgs (propertyName) ); 
} 
} 


(7) 添加 ComputerPlayer 类 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 


namespace Chl3CardLib 
{ 
[Serializable] 
public class ComputerPlayer : Player 
{ 
private Random random = new Random(); 
public ComputerSkillLevel Skill { get; set; } 
public override string PlayerName => $"Computer {Index}"; 


public void PerformDraw(Deck deck, Card availableCard) 
{ 
if (Skill == ComputerSkillLevel. Dumb) 
DrawCard (deck); 
else 
DrawBestCard (deck, availableCard, (Skill == 
ComputerSkillLevel.Cheats)); 
} 
public void PerformDiscard (Deck deck) 
{ 
if (Skill == ComputerSkillLevel. Dumb) 
DiscardCard (Hand[random.Next (Hand.Count)]); 
else 
DiscardWorstCard(); 
} 
private void DrawBestCard (Deck deck, Card availableCard, bool cheat = false) 


{ 
var bestSuit = CalculateBestSuit (); 


if (availableCard.suit == bestSuit) 
AddCard (availableCard); 

else if (cheat == false) 
DrawCard (deck); 

else 


AddCard (deck. SelectCardofSpecificSuit (bestSuit)); 
} 


private void DiscardWorstCard() 
{ 


DiscardCard (Hand.First (x => x.suit == CalculateWorstSuit())); 


} 
private Suit CalculateBestSuit() => OrderSuitsInHand().Last(); 
private Suit CalculateWorstSuit() => OrderSuitsInHand().First(); 


private List<Suit> OrderSuitsInHand () 

{ 
var cardSuits = new Dictionary<Suit, int> 
{ 

Suit.Club, Q ], 

Suit.Diamond, 0 }, 

Suit.Heart, 0 }, 

Suit.Spade, 0 } 


Pali ete ie, 


b 


foreach (var card in Hand) 
cardsuits[card.suit]--; 
return cardsuits.OrderBy(x => x.Value).Select(y => y.Key).ToList(); 


示例 说 明 
本 练习 有 许多 代码 ， 也 做 了 许多 修改 ! 不 过 ， 在 运行 应 用 程序 时 ， 却 看 不 到 什么 变化 。 其 实 是 做 了 许多 修 
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用 几 个 新 方法 扩展 了 Deck 类 。 当 有 牌 堆 (Deci 没 有 牌 时 ， 被 丢弃 的 牌 应 该 回收 到 游戏 中 。 为 此 ， 为 
InsertAllCards 方法 添加 了 一 个 重 载 版 本 ， 用 于 整理 游戏 中 的 有 牌 。 属 性 CardsInDeck 用 于 返回 牌 的 数目 。 如 果 玩 
家 出 了 所 有 的 牌 ， 束 要 把 所 有 被 丢弃 的 牌 回收 到 有 牌 堆 中 ， 并 洗 牌 ， 所 以 Shuffle 方法 允许 Deck 中 可 能 少 于 52 
ikh, ReshuffleDiscarded 77146 VT LEE. Draw 和 SelectCardOfSpecificSuit WH FIER. M FERIENE] 
项 目的 Player 和 ComputerPlayer 类 中 的 大 部 分 代码 部 很 容易 理解 。Player 类 可 以 出 脾 和 弃 凰 ， 这 一 部 分 是 与 
ComputerPlayer 共 于 的， 但 ComputerPlayer E BÉ 84e Wü ERITAR, FTA, MAB RAPS SRE. 
ComputerPlayer 2 48 ye uf A Ee fEBETT 73: 

public void PerformDraw(Deck deck, Card availableCard) 
| if (Skill == ComputerSkillLevel.Dumb) 
DrawCard (deck); 
PO unas avallableCard, (Skill == ComputerSkillLevel 


.Cheats)): 
} 
public void PerformDiscard (Deck deck) 
if (Skill == ComputerSkillLevel.Dumb) 
DiscardCard (Hand[random.Next (Hand.Count)]); 
else 


DiscardWorstCard(); 
} 
private void DrawBestCard(Deck deck, Card availableCard, bool cheat = false) 
{ 
var bestSuit = CalculateBestsuit();: 
if (availableCard.suit == bestsuit) 
AddCard (availableCard); 
else if (cheat == false) 
DrawCard (deck); 
else 
AddCard (deck. SelectCardofSpecificSuit (bestsuit)); 
} 
作 鹃 是 让 电脑 可 以 根据 牌 堆 中 的 牧 选 择 特定 花 色 的 牌 。 如 果 人 允许 电脑 作 静 ， 玩 家 就 更 难 局 了 了 ! 
还 要 注意 ，Player 类 实现 了 INotifyPropertyChanged 接口 ，PlayerName 和 State 属性 会 使 用 它 辐 各 个 玩家 告 


知 目 己 的 变更 。 特 别 是 State 属性 ， 它 的 变化 会 癌 前 推动 整个 游戏 。 


15.4.2 视图 模型 


视图 模型 的 作用 是 保存 显示 它 的 视图 的 状态 。 对 于 Karli Cards， 它 表示 已 经 建立 了 一 个 视图 模型 类 
GameOptions。 这 个 类 会 保存 Options 和 StartGame 窗口 的 状态 。 现在， 还 不 能 从 选项 中 获知 所 选择 的 玩家 信息 ， 
接 下 来 就 添加 这 一 功能 。 还 缺少 Game Client 窗口 的 视图 模型 ， 这 是 下 一 步 要 完成 的 工作 。 

游戏 执行 过 程 的 视图 模型 必须 反映 游戏 中 所 有 的 信息 。 包 括 以 下 几 个 部 分 : 

。 当前 玩家 从 哪个 牌 堆 中 摸 牌 

e 当前 玩家 可 以 抽 中 的 牌 ， 而 不 是 去 摸 牌 

。 当前 玩家 

e 玩家 数量 

视图 模型 还 能 通知 各 个 玩家 发 生 了 更 改 ， 这 也 需要 再 次 实现 INotifyPropertyChanged 接口 。 

除 上 述 功能 外 ， 视 图 模型 还 应 提供 启动 新 一 轮 游戏 的 功能 。 为 此 ， 在 菜单 中 新 建 一 个 路 由 命令 。 该 命令 是 
在 视图 模型 内 部 创建 的 ， 但 由 视图 来 调用 。 


试 一 试 ” 视 图 模型 : KarliCards.Gui 


本 示例 继续 KarliCards.Gui 项 目 。 
(1) 在 GameOptions 类 中 通过 using 语句 添加 如 下 名 称 空间 : 
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using System.Windows.Input; 
using System.IO; 
using System.Xml.Serialization; 


(2) 在 GameOptions 类 中 添加 一 个 新 命令 : 


public static RoutedCommand OptionsCommand = new RoutedCommand ("Show Options", 
typeof (GameOptions), new InputGestureCollection (new List<InputGesture> 
{ new KeyGesture(Key.O, ModifierKeys.Control) ])): 


(3) 在 该 类 中 添加 两 个 新 方法 : 


public void Save() 
{ 


using (var stream = File.Open("GameOptions.xml", FileMode.Create) ) 


var serializer = new XmlSerializer (typeof (GameOptions) ); 
serializer.Serialize(stream, this); 
} 
} 
public static GameOptions Create () 
{ 
if (File.Exists("GameOptions.xml")) 
i 
using (var stream = File.OpenRead ("GameoOptions.xml")) 
{ 
var serializer = new XmlSerializer (typeof (GameOptions)); 
return serializer.Deserialize(stream) as GameOptions; 
} 
} 
else 
return new GameOptions(); 


} 
(4) 修改 OptionsWindow.xaml.cs RS hee Cf FCRI OK 单 击 事件 处 理 程序 ， 如 下 所 示 : 


private void okButton Click(object sender, RoutedEventArgs e) 


{ 
DialogResult = true; 
gameOptions.Save(); 
Close (); 

} 


(5) 删除 构造 函数 中 除 InitializeComponent 调用 之 外 的 所 有 内 容 ， 并 关联 DataContextChanged 事件 : 


public OptionsWindow () 


{ 
gameOptions = GameOptions.Create(); 
DataContext = gameOptions; 
InitializeComponent(); 

} 


(6) 打开 StartGameWindow.xaml.cs (US Rai AAF XepERg ER AU spa 4 1113. AT OME PINES, 
并 选择 Quick Actions and Refactorings... | ExtractMethod， 提 取 一 个 新 方法 ChangeListBoxOptions: 


private void ChangeListBoxoptions () 


{ 
if (gameOptions.PlayAgainstComputer) 
playerNamesListBox.SelectionMode = SelectionMode.Single; 
else 
playerNamesListBox.SelectionMode = SelectionMode.Extended; 
} 


(7) 添加 StartGame DataContextChanged 事件 处 理 程序 : 


void StartGame DataContextChanged (object sender, 
DependencyPropertyChangedEventArgs e) 


gameOptions = DataContext as GameOptions; 
ChangeListBoxOptions (); 
} 


(8) 删除 构造 函数 中 除 InitializeComponent 调用 之 外 的 所 有 内 容 ， 并 关联 DataContextChanged 事件 : 


public StartGameWindow () 
{ 

InitializeComponent (); 

DataContextChanged += StartGame DataContextChanged; 
} 
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(9) 修改 OK 按钮 的 单 击 事件 处 理 程序 : 


private void okButton Click(object sender, RoutedEventArgs e) 


{ 
var gameOptions = DataContext as GameOptions; 
gameOptions.SelectedPlayers = new List<string>() ; 
foreach (string item in playerNamesListBox.SelectedItems) 
{ 
gameOptions.SelectedPlayers.Add (item) ; 
} 
this .DialogResult = true; 
this .Close(); 
} 


(10) 新 建 一 个 类 ， 命 名 为 GameViewModel. HI INotifyPropertyChanged 接口 : 


using Chl3CardLib; 
using System.Collections.Generic; 
using System.ComponentModel; 
using System.Ling; 
using System.Windows. Input; 
namespace KarliCards.Gui 
{ 
public class GameViewModel : INotifyPropertyChanged 
{ 
public event PropertyChangedEventHandler PropertyChanged; 
private void OnPropertyChanged(string propertyName) => 
PropertyChanged?.Invoke (this, new PropertyChangedEventArgs (propertyName)); 
} 
} 


(11) 添加 一 个 用 于 保存 当前 玩家 的 属性 。 该 属性 应 该 使 用 OnPropertyChanged 事件 : 


private Player currentPlayer; 
public Player CurrentPlayer 


{ 
get { return currentPlayer; | 
set 
{ 
currentPlayer = value; 
OnPropertyChanged (nameof (CurrentPlayer) ); 
} 
} 


(12) 与 CurrentPlayer 属性 类 似 ， 表 在 该 类 中 添加 4 个 属性 及 其 相关 的 字段 。 属 性 名 和 字段 名 见 表 15-4. 
表 15-4 属性 名 和 字段 名 


xs TE 


Card CurrentAvailableCard availableCard 


bool GameStarted gameStarted 


(13) 添加 如 下 私有 字段 ， 用 于 保存 游戏 选项 ; 
private GameOptions gameOptions; 


(14) 添加 两 个 路 由 命令 : 


public static RoutedCommand StartGameCommand = 
new RoutedCommand ("Start New Game", typeof (GameViewModel), 
new InputGestureCollection (new List<InputGesture> 
{ new KeyGesture (Key.N, ModifierKeys.Control) })); 
public static RoutedCommand ShowAboutCommand = 
new RoutedCommand ("Show About Dialog", typeof (GameViewModel)); 


(15) 添加 一 个 新 的 默认 构造 函数 : 


public GameViewModel () 

{ 
Players = new List<Player>(); 
gameOptions = GameOptions.Create(); 
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} 
(16) 在 游戏 开始 时 ， 需 要 对 玩家 和 牌 扒 进行 初始 化 。 在 类 中 添加 如 下 代码 : 


public void StartNewGame ( ) 
{ 
if (gameOptions.SelectedPlayers.Count < 1 || 
(gameOptions.SelectedPlayers.Count == | 
&& !gqameOptions.PlayAgainstComputer) ) 
return; 
CreateGameDeck (1 
CreatePlayers (); 
InitializeGame (); 
GameStarted = true; 
} 
private void InitializeGame () 
{ 
AssignCurrentPlayer (0); 
CurrentAvailableCard = GameDeck.Draw(); 
} 
private void AssignCurrentPlayer(int index) 
{ 
CurrentPlayer = Players[index]; 
if (!Players.Any(x => x.State == PlayerState.Winner) ) 
Players.ForEach(x => x.State = (x == Players[index] ? 
PlayerState.Active : 
PlayerState.Inactive)); 
} 
private void InitializePlayer (Player player) 
{ 
player .DrawNewHand (GameDeck) ; 
player.OnCardDiscarded += player OnCardDiscarded; 
player.OnPlayerHasWon += player OnPlayerHasWon; 
Players .Add (player); 
} 
private void CreateGameDeck () 
{ 
GameDeck = new Deck(); 
GameDeck.Shuffle(); 
} 
private void CreatePlayers () 
{ 
Players.Clear(); 
for (var i = 0; i « gameOptions.NumberOfPlayers; i++) 
{ 
if (1 < gameOptions.SelectedPlayers.Count) 
InitializePlayer (new Player 
{ 
Index = i, 
PlayerName = 
gameOptions.SelectedPlayers [i] 
p: 
else 
InitializePlayer(new ComputerPlayer 
{ 
Index = i, 
Skill = 
gameOptions.ComputerSkill 
p: 
} 
} 


(17) 最 后 ， 为 玩家 生成 的 事件 添加 两 个 事件 处 理 程序 : 


void player OnPlayerHasWon (object sender, PlayerEventArgs e) 
{ 
Players .ForEach(x => x.State = (X == e.Player ? PlayerState.Winner : 
PlayerState.Loser)); 
} 
void player OnCardDiscarded(object sender, CardEventArgs e) 
{ 
CurrentAvailableCard = e.Card; 
var nextIndex = CurrentPlayer.Index + 1 >= gameOptions.NumberOfPlayers ? 0 : 
CurrentPlayer.Index + 1; 
if (GameDeck.CardsInDeck -- 0) 
{ 
var cardsInPlay = new List<Card>(); 
foreach (var player in Players) 
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cardsInPlay.AddRange (player.GetCards()); 
cardsInPlay.Add(CurrentAvailableCard); 
GameDeck.ReshuffleDiscarded(cardsInPlay);: 
} 
AssignCurrentPlayer (nextIndex); 


] 


(18) 打开 GameClientWindow.xaml 文件 ， 在 Window 声明 的 下 方 添加 一 个 DataContext 声明 : 


<Window.DataContext > 
<local:GameViewModel /> 
</Window. DataContext> 


(19) 在 CommandBindings 声明 中 添加 三 个 命令 绑 定 : 


«CommandBinding Command-"local:GameViewModel.StartGameCommand" 
CanExecute-"CommandCanEkxecute" Executed-"commandExecuted" /> 
<CommandBinding Command-"local:GameViewModel.ShowAboutCommand" 
CanExecute-"CommandCanEkxecute" Executed-"CommandExecuted" /> 

<CommandBinding Command-"local:GameOptions.OptionsCommand" 
CanExecute-"CommandCanExecute" Executed-"CommandExecuted" /> 


(20) 在 New Game 菜单 中 添加 一 个 命令 : 


<MenuItem Header-" New Game" Style="{StaticResource MainMenuSubMenuItemstyle]" 
Command="1ocal:GameViewModel.StartGameCommand"/> 


(21) 在 Options 采 单 项 中 添加 一 个 命令 : 

Command-"1ocal:GameOptions.OptionsCommand" 

(22) 在 About 玉 蛙 项 中 添加 一 个 命令 : 

Command="local:GameViewModel . ShowAboutCommand" 

(23) 打开 代码 隐 兰 文件， 修改 CommandCanExecute 和 CommandExecuted 方法 ， 如 下 所 示 : 


private void CommandCanExecute (object sender, CanExecuteRoutedEventArgs e) 


{ 


if (e.Command == ApplicationCommands.close) 
e.CanExecute - true; 

if (e.Command == ApplicationCommands. Save) 
e.CanExecute = false; 

if (e.Command == GameViewModel.StartGameCommand) 
e.CanExecute - true; 

if (e.Command == GameOptions.OptionsCommand) 
e.CanExecute - true; 

if (e.Command == GameViewModel .ShowAboutCommand) 


e.CankExecute = true; 
e.Handled = true; 
] 


private void CommandExecuted(object sender, ExecutedRoutedEventArgs e) 


{ 


if (e.Command == ApplicationCommands.Close) 
this.Close(); 
if (e.Command == GameViewModel .StartGameCommand) 


{ 


var model = new GameViewModel (); 
var startGameDialog = new StartGameWindow (); 
var options = GameOptions.Create(); 
startGameDialog.DataContext = options; 
var result = startGameDialog.ShowDialog(); 
if (result.HasValue && result.Value == true) 
{ 

options.Save(); 

model.StartNewGame () ; 

DataContext = model; 


] 
if (e.Command -- GameOptions.OptionsCommand) 
var dialog = new OptionsWindow(); 
var result = dialog.ShowDialog(); 
if (result.HasValue && result.Value == true) 
DataContext = new GameViewModel(); // Clear current game 


if (e.Command == GameViewModel . ShowAboutCommand) 


var dialog = new AboutWindow(); 
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dialog.ShowDialog(); 
} 


e.Handled = true; 


示例 说 明 

本 例 对 代码 进行 了 许多 修改 ， 并 且 在 运行 应 用 程序 时 也 看 不 到 什么 变化 ， 但 菜单 有 变化 。Options 和 New 
Game 菜单 项 都 有 了 快捷 键 ， 可 分 别 使 用 Ctrb-O 和 CtrlHN 来 访问 。 显 示 下 拉 菜 单 时 ， 就 会 看 到 相应 的 提示 。 这 
是 因为 案 单 新 增 了 两 个 命令 ， 分 别 通过 修改 GameOptions.cs 和 GameViewModel.cs 来 完成 : 


public static RoutedCommand OptionsCommand = new RoutedCommand ("Show Options", 
typeof (GameOptions), new InputGestureCollection(new List<InputGesture> 
{ new KeyGesture(Key.O, ModifierKeys.Control) })); 
public static RoutedCommand StartGameCommand = 
new RoutedCommand ("Start New Game", typeof (GameViewModel), 
new InputGestureCcollection (new List<InputGesture> 
{ new KeyGesture (Key.N, ModifierKeys.Control) })); 


将 InputGesture 列表 指派 给 该 命令 时 ， 快 捷 键 会 目 动 与 人 单项 关联 起 来 。 
在 洲 戏 客户 闯 的 代码 隐 志 文件 中 ， 还 渍 加 了 代码 ， 让 两 个 窗口 显示 为 对 话 杠 : 


if (e.Command == GameViewModel.StartGameCommand) 
{ 
var model = new GameViewModel (); 
var startGameDialog = new StartGameWindow(); 
startGameDialog.DataContext = model.GameOptions; 
var result = startGameDialog.ShowDialog(); 
if (result.HasValue && result.Value == true) 
{ 
model.GameOptions.Save (); 
model .StartNewGame (); 
DataContext = model; 
} 
} 


将 窗口 显示 为 对 话 框 ， 就 可 以 返回 一 个 值 ， 表 示 是 否 应 使 用 对 话 框 的 结果 。 不 能 从 窗口 直接 返回 一 个 值 ; 

而 要 将 窗口 的 DialogResult 属性 设置 为 true 或 false， 以 表示 成 功 或 失败 : 

private void okButton Click(object sender, RoutedEventArgs e) 

l this.DialogResult = true; 

this.Close(); 
} 
第 14 章 提 到 ， 如 果 对 现 有 对 象 实例 设置 DataContext， 就 必须 通过 代码 来 实现 。 之 前 介绍 的 代码 的 确 是 这 

样 ， 但 现在 应 用 程序 启动 时 ，GameClientWindowxaml 中 的 XAML 也 实例 化 了 一 个 新 实例 : 


<Window.DataContext > 
<local:GameViewModel /> 
</Window. DataContext> 


这 个 实例 确保 视图 中 有 一 个 DataContext， 但 在 与 StartGame 命令 中 的 新 实例 互 用 之 前 ， 它 没有 太 多 用 处 。 
GameViewModel 包含 许多 代码 ， 但 大 多 数 只 是 玩家 和 Deck 实例 的 属性 和 实例 化 。 
游戏 开始 后 ， 玩 家 的 状态 和 GameViewModel 使 游戏 在 电脑 和 玩家 做 出 选择 后 同 前 推进 。PlayerHasWon 事 
件 在 GameViewModel 中 处 理 ， 以 确保 其 他 玩家 的 状态 切换 为 Losers 
void player OnPlayerHasWon(object sender, PlayerEventArgs e) 


{ 


Players.ForEach(x => x.State = (x == e.Player ? PlayerState.Winner : 
PlayerState.Loser)); 
} 


为 玩家 创建 的 其 他 事件 也 会 在 这 里 处 理 ， CardDiscarded 用 于 表明 某 个 玩家 完成 了 自己 该 轮 中 的 任务 。 这 会 
使 CurrentPlayer 被 设置 为 下 一 个 玩家 : 


void player OnCardDiscarded(object sender, CardEventArgs e) 
{ 
CurrentAvailableCard = e.Card; 
var nextIndex = CurrentPlayer.Index + 1 >= gameOptions.NumberOfPlayers ? 0 : 
CurrentPlayer.Index + 1; 
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if (GameDeck.CardsInDeck == 0) 

{ 
var cardsInPlay = new List<Card>(); 
foreach (var player in Players) 

cardsInPlay.AddRange (player.GetCards()); 

cardsInPlay.Add(CurrentAvailableCard); 
GameDeck.ReshuffleDiscarded (cardsInPlay); 

} 


AssignCurrentPlayer (nextIndex) ; 
} 
EAE Reh EE Pe I A. RRA, SPAS ee A BER A 
JEAEJX — T TI EE IRE, SBA PLT FR 
从 GameClientWindow.xaml.cs 代码 隐藏 文 件 的 CommandExecuted 方法 中 调用 StartGame 方法 。 访 方法 使 用 
三 个 方法 来 新 建 一 个 牌 堆 ， 并 为 玩家 友 牌 ， 最 后 设置 好 CurrentPlayer， 就 可 以 开始 游戏 了 。 


1543 大功告成 


现在 ， 整 个 游戏 已 经 编写 好 了 ， 但 还 不 能 玩 ， 因 为 游戏 客户 端 还 没有 任何 显示 。 要 让 游戏 运行 起 来 ， 还 需 
要 使 用 DockPanel 将 男 两 个 用 尸 控 件 放 到 游戏 客 尸 问 中 。 

这 两 个 用 尸 控 件 是 CardsInHand 和 GameDecks， 前 者 用 于 显示 玩家 的 一 手 牌 ， 后 者 用 于 显示 主 牌 堆 和 可 用 
的 牌 。 


试 一 试 ” 大功告成 : KarliCards.Gui 


本 例 继续 开发 KarliCards.Gui 项 目 。 
(1) 右 击 GameClient 项 目 ， 并 选择 Add | User Control， 新 建 一 个 用 户 控件 ， 命 名 为 CardsInHandControl。 
(2) 在 Grid 中 添加 Label 和 Canvas 控件 : 


<Grid> 
«Label Name-"PlayerNameLabel" Foreground-"White" FontWeight-"Bold" 
FontSize-"]4" > 
«Label.Effect- 
<DropShadowEffect ShadowDepth-"5" Opacity-"0.5" Direction-"145" /> 
«/Label.Effect- 
</Label> 
«Canvas Name-"CardSurface"- 
</Canvas> 
</Grid> 


(3) 打开 代码 隐藏 文件 ， 添 加 下 列 using 指令 : 


using Chl3CardLib; 

using System; 

using System.Threading; 

using System.Windows; 

using System.Windows.Controls; 
using System.Windows.Input; 
using System.Windows.Media; 
using System.Windows.Threading; 


(4) 我 们 需要 4 个 依赖 属性 。 输 入 propdp， 然 后 按 下 Tab 键 , 即 可 插入 属性 模板 。 在 其 中 插入 Type. Name. 
OwnerClass 以 及 默认 值 。 使 用 Tab 键 从 一 个 值 切换 到 下 一 个 值 。 按 照 表 15-5 所 示 设 置 名 个 值 。 编 辑 完 所 有 值 
后 ， 束 按 下 回 车 键 ， 结 束 模 板 的 创建 。 


表 15-5 CardsinHandControl 的 依赖 属性 


类 型 
Player 
Gan Viel "i 
Orientation CardsInHandControl Orientation.Horizontal 
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(5) 在 Owner. PlayerState 和 PlayerOrientation 的 属性 发 生 更 改 时 ， 添 加 要 使 用 的 回调 方法 。 


private static void OnOwnerChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs e) 


var control = source as CardsInHandControl; 
control.RedrawCards (); 


} 
private static void OnPlayerStateChanged (DependencyObject source, 
DependencyPropertyChangedEbEventArgs e) 


var control = source as CardsInHandControl; 
var computerPlayer = control.Owner as ComputerPlayer; 
if (computerPlayer !- null) 
{ 
if (computerPlayer.State == PlayerState.MustDiscard) 


{ 


Thread delayedWorker = new Thread (control.DelayDiscard); 
delayedWorker.Start (new Payload { Deck = control.Game.GameDeck, 
AvailableCard = control.Game.CurrentAvailableCard, Player = computerPlayer }); 
} 
else if (computerPlayer.State == PlayerState.Active) 
{ 
Thread delayedWorker = new Thread (control.DelayDraw); 
delayedWorker.Start (new Payload { Deck = control.Game.GameDeck, 
AvailableCard = control.Game.CurrentAvailableCard, Player = computerPlayer }); 
} 
] 


control.RedrawCards(): 


] 
private static void OnPlayerOrientationChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs args) 
{ 
Var control = source as CardsInHandControl; 
control.RedrawCards (); 


} 
(6) 回调 方法 需要 一 系列 辅助 方法 。 前 先 添 加 一 个 私有 类 和 两 个 方法 ， 这 两 个 方法 由 OnPlayerStateChanged 
方法 的 delayedWorker 线程 使 用 。 


private class Payload 
{ 
public Deck Deck { get; set; } 
public Card AvailableCard { get; set; } 
public ComputerPlayer Player { get; set; } 
} 
private void DelayDraw (object payload) 
{ 
Thread.Sleep (1250); 
Var data = payload as Payload; 
Dispatcher.Invoke (DispatcherPriority.Normal, 
new Action<Deck, Card>(data.Player.PerformDraw), data.Deck, data.AvailableCard); 
} 
private void DelayDiscard(object payload) 
{ 
Thread.Sleep (1250); 
Var data = payload as Payload; 
Dispatcher. Invoke (DispatcherPriority.Normal, 
new Action<Deck>(data.Player.PerformDiscard), data.Deck); 
} 
"1 N— —Jr H. j NE c A à 有 M " j= 4 5 ' l LA. J vaj x ura RH 
(7) Owner 属性 需要 一 个 在 属性 更 改 时 调用 的 回调 方法 。 可 将 其 指定 为 PropertyMetadata 类 的 构造 函数 的 第 
c à 4 [RS f | vaje = whe i a a : E ^ | F | E- wh A wwa f i “aT 
二 个 参数 ， 这 个 构造 图 数 作为 register0 方 法 的 第 4 个 参数 。 修 改 注册 代码 ， 如 下 : 
public static readonly DependencyProperty OwnerProperty = 
DependencyProperty.Register ( 
"Owner", 
typeof (Player), 


typeof (CardsInHandControl), 
new PropertyMetadata (null, new PropertyChangedCallback (OnOwnerChanged) )); 


(8) 与 Owner 属性 类 似 ，PlayerState 和 PlayerOrientation 属性 也 应 注册 一 个 回调 方法 。 为 这 两 个 属性 重复 第 
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(7) 步 ， 将 OnPlayerStateChanged 和 OnPlayerOrientationChanged 作为 回调 方法 的 名 称 。 
(9) 添加 用 来 绘制 控件 的 方法 : 


private void RedrawCards () 
{ 
CardSurface.Children.Clear(); 
if (Owner == null) 
i 
PlayerNameLabel.Content - string.Empty; 
return; 
} 
DrawPlayerName () ; 
DrawCards (); 
} 
private void DrawCards () 


{ 


bool isFaceup = (Owner.State != PlayerState.Inactive); 
if (Owner is ComputerPlayer) 
isFaceup = (Owner.State == PlayerState.Loser || 
Owner.State == PlayerState.Winner); 
var cards = Owner.GetCards(); 
if (cards == null || cards.Count == 0) 
return; 
for (var 1 = 0; i < cards.Count; i++) 
{ 
Var cardControl = new CardControl (cards[i]); 
if (PlayerOrientation == Orientation.Horizontal) 
cardControl.Margin - new Thickness(i * 35, 35, 0, 0); 
else 


cardControl.Margin = new Thickness(5, 35 + 1 * 30, O0, 0); 
cardControl.MouseDoubleClick += cardControl MouseDoubleClick; 
cardControl.IsFaceUp = isFaceup; 
CardSurface.Children.Add(cardControl); 

} 
} æ . 
private void DrawPlayerName () 


{ 


if (Owner.State == PlayerState.Winner || Owner.State == 
PlayerState.Loser) 
PlayerNameLabel.Content = Owner.PlayerName + 
(Owner.State == PlayerState.Winner ? 
" is the WINNER" : " has LOST"); 
else 
PlayerNameLabel.Content = Owner.PlayerName; 
var isActivePlayer - (Owner.State -- PlayerState.Active || 
Owner.State == PlayerState.MustDiscard); 


PlayerNameLabel.FontSize = isActivePlayer ? 18 : 14; 
PlayerNameLabel.Foreground = isActivePlayer ? 

new SolidColorBrush(Colors.Gold) : 

new SolidColorBrush(Colors.White); 


} 
(10) 最 后 ， 添 加 玩家 双击 纸牌 时 调用 的 处 理 程序 : 


private void cardControl MouseDoubleClick(object sender, 
MouseButtonEventArgs e) 


{ 


var selectedCard = sender as CardControl; 


if (Owner == null) 
return; 
if (Owner.State == PlayerState.MustDiscard) 


Owner.DiscardCard (selectedCard.Card); 
RedrawCards(); 


} 
(11) 按照 步 又 (1) 创 建 男 一 个 用 尸 控 件 ， 命 名 为 GameDecksControl. 
(12) 删除 Grid 控件 ， 插 入 一 个 Canvas 控件 : 
«Canvas Name-"controlCanvas" Width-"250" /> 
(13) 打开 代码 隐藏 文件 ， 在 其 中 引用 下 列 名 称 空间 : 


using Ch13CardLib; 

using System.Collections.Generic; 
using System.Linq; 

using System.Windows; 

using System.Windows.Controls; 
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using System.Windows.Documents; 
using System.Windows.Input; 


(14) 按照 步骤 (4 添加 4 个 依赖 属性 ， 相 应 的 值 如 表 15-6 所 示 。 


表 15-6 GameDecksControl 的 依赖 属性 


x m RA 
bool GameDecksControl false 
Deck p HN GameDecksControl 


Card AvailableCard 


GameDecksControl 


(15) 添加 DrawDecks 方法 : 


private void DrawDecks ( ) 
{ 
controlCanvas.Children.Clear(); 
if (CurrentPlayer == null || Deck == null || !GameStarted) 
return; 
List«CardControl» stackedCards = new List<CardControl>(); 
for (int i = 0; i « Deck.CardsInDeck; i++) 
stackedCards.Add(new CardControl(Deck.GetCard(i)) { Margin = 
new Thickness(150 + (i * 1.25), 25 —- (1 * 1.25), 0, 0), IsFaceUp = false }); 
if (stackedCards.Count > 0) 
stackedCards.Last().MouseDoubleClick += Deck MouseDoubleClick; 
if (AvailableCard != null) i 
{ 
var availableCard = new CardControl(AvailableCard) { Margin = 
new Thickness(0, 25, 0, 0) }? 
availableCard.MouseDoubleClick += AvailalbleCard MouseDoubleClick; 
controlCanvas.Children.Add(availableCard); 
} 


stackedCards.ForEach(x => controlCanvas.Children.Add(x)); 


} 


(16) 279814) PSN 4 个 依赖 属性 都 需要 在 属性 更 改 时 调用 回调 方法 。 按 照 第 (3) 步 添加 各 个 回调 方法 ， 
分 别 命名 为 OnGameStarted. OnPlayerChanged. OnDeckChanged 和 OnAvailableCardChanged. 
(17) 添加 回调 方法 ， 代 码 如 下 : 


private static void OnGameStarted(DependencyObject source, 
DependencyPropertyChangedbventArgs e) => (source as GameDecksControl)? 
. DrawDecks (); 


private static void OnDeckChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs e) => (source as GameDecksControl)?.DrawDecks(): 


private static void OnAvailableCardChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs e) => (source as GameDecksControl)? 
.DrawDecks(); 


private static void OnPlayerChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs e) 
{ 
var control = source as GameDecksControl; 
if (control.CurrentPlayer == null) 
return; 
control.CurrentPlayer.OnCardDiscarded += 
control.CurrentPlayer OnCardDiscarded; 
control .DrawDecks (); 
} 
private void CurrentPlayer OnCardDiscarded(object sender, CardEventArgs e) 
{ 
AvailableCard = e.Card; 
DrawDecks(); 
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(18) 最 后 为 纸牌 添加 下 列 事件 处 理 程序 : 


void AvailalbleCard MouseDoubleClick (object sender, MouseButtonEventArgs e) 
{ 


if (CurrentPlayer.State != PlayerState.Active) 
return; 
Var control = sender as CardControl; 


CurrentPlayer.AddCard(control.Card); 
AvailableCard - null; 
DrawDecks (); 


] 
void Deck MouseDoubleClick(object sender, MouseButtonEventArgs e) 
{ 

if (CurrentPlayer.State != PlayerState.Active) 


return; 
CurrentPlayer.DrawCard (Deck); 
DrawDecks (); 


} 
(19) 回 到 GameClientWindow.xaml 文件 ， 删 除 Row 2 中 的 Grid 控件 ， 插 入 下 列 新 的 DockPanel 控件 : 


<DockPanel Grid.Row="2"> 
«local:CardsInHandControl x:Name-"Player2Hand" DockPanel.Dock-"Right" 
Height-"380" Game="{Binding}" 

VerticalAlignment-"Center" Width-"180" PlayerOrientation-"Vertical" 
Owner="{Binding Players[1])" PlayerState="{Binding Players[1].State]" /> 

«local:CardsInHandControl x:Name-"Player4Hand" DockPanel.Dock-"Left" 
HorizontalAlignment-"Left" Height-"380" VerticalAlignment-"Center" 
PlayerOrientation-"Vertical" Owner="{Binding Players[3])" Width-"180" 
PlayerState="{Binding Players[3].State}" Game="{Binding}"/> 

«local:CardsInHandControl x:Name-"PlayerlHand" DockPanel.Dock-"Top" 
HorizontalAlignment-"Center" Height-"154" VerticalAlignment-"Top" 
PlayerOrientation-"Horizontal" Owner="{Binding Players[0])" Width="380" 
PlayerState="{Binding Players[0].State}" Game="{Binding}"/> 

«local:CardsInHandControl x:Name-"Player3Hand" DockPanel.Dock-"Bottom" 
HorizontalAlignment-"Center" Height-"154" VerticalAlignment-"Top" 
PlayerOrientation-"Horizontal" Owner="{Binding Players[2])" Width="380" 
PlayerState-"[Binding Players[2].State}" Game="{Binding}"/> 

<local:GameDecksControl Height="180" x:Name="GameDecks" 

Deck="{Binding GameDeck}" 
AvaillableCard="{Binding CurrentAvailableCard}" 
CurrentPlayer="{Binding CurrentPlayer}" 
GameStarted="{Binding GameStarted}"/> 
</DockPanel> 


(20) 运行 该 应 用 程序 。 会 默认 启用 ComputerPlayer 类 ， 玩 家 数目 会 设置 为 两 个 。 也 就 是 说 ， 在 Start Game 
对 话 框 中 选择 一 个 玩家 即 可 。 随 后 ， 就 可 以 看 到 如 图 15-5 所 示 的 画面 。 
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图 15-5 
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示例 说 明 
尽管 本 练习 包含 了 很 多 代码 ， 但 其 中 大 部 分 都 是 依赖 属性 ， 而 XAML 痢 是 为 这 些 属性 进行 数据 绑 定 的 。 


CardsInHandControl 创建 了 三 个 属性 Game. Owner 和 PlayerState， 用 来 显示 上 自己 ， 并 啊 应 更 改 。 其 中 Game 和 
Owner EHF Rh, PlayerState 还 能 用 来 控制 ComputerPlayer 操作 。 


private static void OnPlayerStateChanged (DependencyObject source, 
DependencyPropertyChangedEventArgs e) 
{ 


var control = source as CardsInHandControl; 
Var computerPlayer = control.Owner as ComputerPlayer; 
if (computerPlayer != null) 
{ 
if (computerPlayer.State == 
{ 


Thread delayedWorker = new Thread (control.DelayDiscard); 
delayedWorker.Start (new Payload 
{ 


Deck = control.Game.GameDeck, 


PlayerState.MustDiscard) 


AvailableCard = control.Game.CurrentAvailableCard, 
Player — computerPlayer 
); 
} 
else if (computerPlayer.State == 
{ 
Thread delayedWorker = new Thread (control.DelayDraw); 
delayedWorker.Start (new Payload 
{ 
Deck = control.Game.GameDeck, 
AvailableCard = control.Game.CurrentAvailableCard, 
Player — computerPlayer 
); 
} 
} 
control .RedrawCards (); 


} 


OnPlayerStateChanged 方法 用 来 啊 应 玩家 状态 的 变化 ， 判 断 当 前 玩家 是 不 是 ComputerPlayer. Wize, 


PlayerState.Active) 


DNO 
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保 电脑 玩家 摸 牌 或 弃 牌 。 这 种 情况 下 ， 它 会 创建 一 个 工作 线程 ， 并 在 该 线程 上 执行 相应 的 方法 。 这 样 可 保证 电 
脑 在 等 待 时 ， 应 用 程序 能 继续 工作 : 
private void DelayDraw (object payload) 
{ 
Thread.Sleep (1250); 
var data = payload as Payload; 
Dispatcher. Invoke (DispatcherPriority.Normal, 
new Action<Deck, Card>(data.Player.PerformDraw), data.Deck, data.AvailableCard); 


} 
Dispatcher 用 于 发 起 调用 ， 以 保证 调用 是 在 GUI 线程 上 发 生 的 。 
纸牌 的 绘制 很 简单 。 程 序 会 根据 PlayerOrientation 中 的 设置 ， 将 它们 水 平 或 垂直 排列 。 
GameDecksControl 控件 使 用 CurrentPlayer 类 获得 CurrentPlayer 的 变更 通知 。 当 玩家 发 生 交 将 时 ， 它 会 将 该 
玩家 关联 a 到 CardDiscarded HFE, EHAZE REAT APEA. 
最 后 在 游戏 客户 中 中 添加 一 个 DockPanel， 在 其 每 一 边 插入 一 个 CardsInHandControl 控件 ， 在 中 间 插 入 一 
个 GameDecksControl 控件 : 


«local:CardsInHandControl x:Name-"PlayerlHand" DockPanel.Dock-"Top" 
HorizontalAlignment-"Center" Height-"154" verticalAlignment-"Top" 
PlayerOrientation-"Horizontal" Owner="{Binding Players[0])" Width="380" 
PlayerState="{Binding Players[0].5tate]" Game="{Binding}"™ /> 


Game [Nix ^ be EO Pul] DataContext 与 CardsInHandControl 的 Game 属性 直接 绑 定 起 来 。 
PlayerState 被 绑 定 到 玩家 的 State TE. AOL, 7199 SA 0 的 玩家 将 访问 该 状态 。 


15.5 ”习题 


(1) 这 个 游戏 客户 端 存在 一 个 问题 : 在 Options 对 话 框 中 可 以 设置 电脑 玩家 的 级 别 ， 但 下 次 打开 Options 
对 话 框 时 ， 其 中 的 单 选 按钮 却 没 有 更 新 ， 以 反映 上 次 的 选择 。 其 部 分 原因 是 没有 相关 的 更 新 代码 ， 另 一 部 分 原 
因 是 没有 值 转换 器 对 ComputerSkillLevel 进行 转换 。 请 新 建 一 个 值 转换 器 ， 然 后 设置 IsChecked 绑 定 ， 来 蔡 代 目 
前 使 用 的 Checked 事件 。 

提示 : 此 题 需要 用 到 Converter 绑 定 中 的 ConverterParameter 部 分 。 

(2) FRAT EM ERE, Soar SA a WERE. TATE Options 对 话 框 中 添加 一 个 选项 ， 以 显示 电脑 的 牌 面 。 

(3) 在 洲 戏 客户 站 的 展 部 创建 一 个 状态 栏 ， 显 示 游 戏 的 当前 状态 。 

附录 A 给 出 了 习题 答案 。 


15.6 本章 要 点 


to o8 要 A 

使 用 样式 , 可 为 XAML 元 素 创建 能 在 许多 元 素 中 重复 使 用 的 样式 。 样 式 允 许 设 置 元 素 的 属性 。 把 茶 个 元 素 的 Style 
属性 设置 为 预定 义 的 样式 时 ， 该 元 素 的 属性 就 会 使 用 Style 属性 中 指定 的 值 

模板 模板 用 于 定义 控件 的 内 容 。 通 过 模板 ， 可 改变 标准 控件 的 显示 方式 ， 还 可 建立 复杂 的 目 定 义 控件 

P | 用 户 控 件 用 来 创建 便于 在 目 己 的 项 目 中 重复 使 用 的 代码 和 XAML。 这 些 代 码 和 XAML 也 可 以 导出 到 其 他 项 目 中 


样式 
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16. 


基本 的 云 编程 


本 章 内 容 : 

e 理解 云 、 云 编程 和 云 优 化 堆栈 

e 使 用 云 设 计 模式 为 云 编程 

e 使 用 Microsoft Azure C# 库 创建 存储 容器 
e 创建 使 用 存储 容器 的 ASP.NET 4.7 网 站 


本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 FR. 下载 代码 位 于 Chapter16 文件 夹 中 并 已 根据 本 章 示 例 的 名 称 单 
Mer E. 


本 书 中 ，C# 编 程 的 基础 知识 主要 使 用 控制 台 应 用 程序 、 通 过 WPF SCHL s tir jw. Hd REF Windows 通用 应 
用 程序 来 呈现 。 虽 然 这 些 都 是 引 人 注 目的 可 行 开 发 技术 ， 但 它们 并 非 在 云 中 驻 留 和 运行 恨 好 的 程序 示例 。 这 些 
程序 一 般 部 羞 、 运 行 在 用 户 的 计算 机 、 平 板 电 脑 或 移动 设备 上 。 这 些 程序 被 编 详 成 可 执行 文件 或 动态 链接 库 ， 
依赖 NET Framework 等 预 次 软件 。 所 依赖 的 这 些 预 闻 软 件 通 和 存 在 于 安 闻 上 述 程序 的 位 置 ， 或 者 包含 在 安 逆 过 
程 中 。 与 此 相反 ， 在 云 中 运行 的 互联 网 应 用 程序 (如 基于 ASPNET 的 应 用 程序 ) 就 不 能 要 求 访 问 该 程序 的 计算 机 
或 设备 上 存在 任何 此 类 库 或 依赖 的 预 凌 软件 。 所 有 依赖 项 都 安 冯 在 托管 互联 网 应 用 程序 的 服务 右上， 并 由 设备 
使 用 协议 (如 HTTP. WS(Web Socket), FTP 或 SMTP 等 ) 来 访问 。 虽 然 控 制 台 、 果 面 和 Windows 通用 应 用 程序 
可 在 云 中 有 依赖 的 预 装 软 件 ， 如 数据 库 、 存 储 容器 或 Web 服务 ， 但 它们 目 己 一 般 不 驻 留 在 云 中 。 

通过 Web 浏览 器 访问 、 啊 应 REST API Bk WCF 服务 请 求 的 程序 非常 适 于 在 云 中 运行 。 用 于 创建 这 些 程序 
类 型 的 开 上 友 拉 术 不 需要 在 调用 它们 的 设备 上 内 置 任何 所 依赖 的 预 凌 软件 。 一 般 情 况 下 ， 这 些 程序 类型 只 是 役 此 
区 换 信息 ， 以 清晰 、 用 户 友 好 的 方式 呈现 数据 。 此 外 ， 接 收 和 处理 大 量 数 据 的 程序 也 非 肖 适合 在 云 中 运行 ， 因 
为 利用 高 可 扩展 性 的 资源 接收 和 处 理 数据 是 云 本 喘 的 一 个 基本 特性 。 

本 章 将 概述 什么 是 云 计算 , 列举 在 云 中 成 功 运 行程 序 的 一 些 模式 和 拉 术 示例 ,以 及 在 ASP.NET 网 站 上 创建 
和 使 用 云 资源 的 示例 。 
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16.1 云 、 云 计算 和 云 优 化 堆栈 

开始 创建 完全 或 部 分 运行 在 云 上 的 应 用 程序 只 是 时 间 问 题 ， 不 再 是 “是 否 创建 >， 而 是 “ 何 时 创建 >。 诀 定 
程序 的 哪些 组 件 运 行 在 云 中 、 云 类 型 和 云 服 务 模型 ， 需 要 一 些 调 但 、 理 解 和 计划 。 对 于 初学 者 ， 必 须 清楚 什么 
是 云 。 云 只 是 运行 在 一 个 数据 中 心 的 大 量 商品 化 计算 机 硬件 ， 这 个 数据 中 心 可 以 运行 程序 ， 存 储 大 量 数据 。 区 
别 是 弹性 ， 即 动态 同上 扩展 的 能 力 (例如 增加 CPU 和 内 存 ) 和 /或 动态 回 外 扩展 的 能 力 (例如 增加 虚拟 服务 器 实例 
的 数量 )， 而 收缩 时 似乎 时 不 费力 。 这 与 当前 的 开 运营 格局 完全 不 同 ， 在 当前 的 开 运 音 格 局 中 ， 被 区 分 开 来 的 
计算 机 资源 在 公司 的 一 个 领域 往往 会 部 分 或 完全 未 使 用 ， 而 在 其 他 领域 又 严重 缺乏 计算 机 资源 。 云 解决 了 这 个 
问题 ， 云 可 以 在 需要 时 提供 对 计算 机 资源 的 访问 ， 在 不 需要 它们 时 ， 就 将 这 些 资 源 提 供给 别人 。 对 于 个 人 开发 
者 ， 云 可 以 用 于 部 署 程序 ， 回 外 界 会 布 。 如 果 程 序 比较 受 欢 迎 ， 就 可 以 扩展 它 来 满足 资源 需求 ;如果 程序 失败 
了 ， 也 不 必 耗 费 太 多 的 金钱 和 时 间 来 建立 专用 的 计算 机 硬件 和 基础 设施 。 

下 面 将 详细 地 探讨 云 交 型 和 云 服务 模型 。 和 并 见 的 云 类 型 有 公共 云 、 私 有 云 和 混合 云 ， 图 16-1 列 出 了 这 几 种 
ZA, 


没有 共享 的 基础 设施 缺少 控制 


图 16-1 


e 公共 云 : 公共 云 是 共 圣 云 提 供 商 拥有 和 运营 的 计算 机 硬件 和 基础 设施 ， 云 提供 商 有 Microsoft Azure. 
Amazon AWS, Rackspace 或 IBM Cloud。 对 于 中 小 企业 而 言 ， 如 果 所 管理 的 客户 和 用 户 要 求 不 断 流 动 ， 
这 种 云 类 型 将 非常 适合 。 

e 私有 云 : 这 是 位 于 现场 或 外 包 数 据 中 心 的 专用 计 复 机 硬件 和 基础 设施 。 这 种 云 适 用 于 大 公司 、 必 须 提 
供 更 高 级 别 数据 安全 性 的 公司 以 及 政府 机 构 。 
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e BAG: 这 是 公共 云 和 私有 云 的 组 合 类 型 ， 在 这 种 类 型 中 ， 要 选择 IT 解决 方案 的 哪些 部 分 在 私有 云 上 
运行 ， 哪 些 部 分 在 公共 云 上 运行 。 理 想 的 解决 方案 是 在 私有 云 上 运行 对 业务 至 关 重 要 的 、 需 要 更 高 安 
全 级 别 的 程序 ， 在 公共 云 上 运行 不 敏感 、 可 能 失效 的 任务 。 

云 服 务 模型 的 数量 在 不 断 增加 ， 但 最 常见 的 云 服务 模型 如 下 所 示 ， 男 见 图 16-2. 

e 基础 设施 即 服务 (Infrastructure as a Service, laaS): 要 从 操作 系统 开始 向 上 和 负责。 不 负责 硬件 或 网 络 
设施 ， 但 负责 操作 系统 补丁 和 第 三 方 依赖 库 。 

e 平台 即 服务 (Platform as a Service, PaaS): 只 负责 运行 在 所 选 操作 系统 上 的 程序 及 其 依赖 项 。 不 负责 
操作 系统 维护 、 硬 件 或 网 络 基础 设施 。 

e 软件 即 服务 (Software as a Service, SaaS): 通过 互联 网 访问 设备 使 用 软件 程序 或 服务 。 例 如 ，Office 
365. Salesforce, OneDrive 或 Box， 痢 可 通过 互联 网 连接 在 任意 位 置 进行 访问 ， 并 非 只 有 将 软件 安装 在 
客户 端 才能 起 作用 。 只 需要 负责 运行 在 平台 上 的 软件 。 

客户 
Web 客户 、 移 动 应 用 等 


Saas 


Office 365. CRM JAE., Outlook.com, WR 


PaaS 
开发 工具 、 数 据 库 、Web 服务 器 ， 运 行 库 DLL 等 


IaaS 
物理 机 器 、 虚 拟 机 器 、 存 储 器 、 网 络 等 


16-2 


总 之 ， 云 是 一 个 商品 化 、 弹 性 化 的 计算 机 硬件 结构 ， 用 于 运行 程序 。 在 混合 云 、 公 共 云 或 私有 云 类 型 中 ， 
这 些 程序 运行 在 IaaS. PaaS 或 SaaS 服务 模型 上 。 

云 编程 就 是 开发 运行 在 任何 云 服 务 模型 上 的 代码 逻辑 。 云 程序 应 该 具有 可 移植 性 、 可 伸缩 性 和 弹性 模式 ， 
改善 程序 的 性 能 和 稳定 性 。 没 有 实现 这 些 可 移植 性 、 可 伸缩 性 和 弹性 模式 的 程序 可 运行 在 云 中 ,但 某 些 情况 下 ， 
诸如 硬件 故障 或 网 络 延迟 的 问题 可 能 导致 程序 执行 意外 的 代码 路 径 ， 并 终止 。 


注意 : 


有 关 云 编程 模式 和 最 佳 实践 方式 的 讨论 ， 请 参见 下 一 节 。 


弹性 是 云 最 大 的 优点 ， 这 很 重要 ， 因 为 不 仅 平 台 可 以 扩展 ， 云 程序 也 可 以 扩展 。 例 如 ， 代 码 依 赖 后 端 资源 、 
数据 库 、 读 取 或 打开 文件 ， 还 是 通过 大 数据 对 象 来 解析 ? 将 此 类 功能 操作 放 在 云 程 序 中 时 ， 会 降低 其 伸缩 性 ， 
因此 文 持 较 低 的 吞吐 量 。 要 确保 云 程 序 管 理 的 代码 路 径 能 执行 长 期 运行 的 方法 ， 如 有 必要 ， 可 将 它们 放 进 一 种 
离线 处 理 机 制 。 

云 优化 堆栈 是 一 个 概念 ， 指 代码 可 处 理 高 吞吐 量 ， 占 用 空间 小 ， 可 与 其 他 应 用 程序 一 起 运行 在 同一 台 服 务 
器 上 ， 还 可 以 跨 平 台 使 用 。“ 占 用 空间 小 ” 指 仅 把 存在 依赖 的 组 件 打 包 到 云 程序 中 ， 使 部 署 尺 寸 尽 可 能 小 。 考 虑 
一 下 云 程序 是 否 需 要 整个 NET Framework 才能 运行 。 如 果 不 需 要 整个 NET Frameworkk， 那 承 只 包括 运行 云 程序 
所 需 的 库 ， 然 后 把 云 程序 编译 到 一 个 自 包含 的 应 用 程序 中 以 支持 并 行 执行 。 云 程序 可 与 其 他 任何 云 程 序 一 起 运 
行 ， 因 为 它 在 二 进 制 包 中 包含 了 所 需 的 依赖 项 。 最 后 ， 使 用 开源 版 本 的 Mono、.NET Core 或 ASPNET Core, 
将 可 以 把 云 程 序 打包 、 编 译 、 部 署 到 Microsoft 之 外 的 操作 系统 (例如 macOS、iOS £X Linux) E. 
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16.2 云 模 式 和 最 佳 实践 


在 云 中 ， 仅 允许 较 短 的 延迟 或 停机 时 间 ， 代 码 必 须 为 此 做 好 准备 ， 代 码 要 包含 从 这 些 平 台 异 常 中 成 功 恢复 
的 逻辑 。 如 果 以 前 曾 现场 编码 ， 或 编写 就 地 执行 的 程序 代码 ， 这 是 一 个 重要 的 思想 转变 。 需 要 忘掉 很 多 有 关 管 
理 异 常 的 东西 ， 学 会 接受 失败 ， 并 创建 从 这 种 失败 中 恢复 的 代码 。 
上 一 节 中 提 到 了 可 移植 性 、 可 伸缩 性 和 弹性 等 概念 ， 需 要 将 这 些 概念 集成 到 在 云 运行 中 的 程序 里 。 但 这 里 
的 可 移植 性 有 什么 特殊 含义 ? 如 果 程 序 可 在 多 个 平台 上 移动 或 执行 ， 例 如 Windows、Linux 和 macOS， 该 程序 
就 是 可 移植 的 。 一 些 ASPNET Core 特性 位 于 开源 技术 的 新 堆栈 上 ， 为 开发 人 员 提 供 把 代码 编译 到 二 进 制 文件 
中 的 选项 ， 以 便 在 这 些 平台 上 运行 。 传 统 上 ， 开 发 人 员 使 用 ASPNET 编写 程序 ， 在 后 台 运 行 C#， 使 用 US 在 
Windows 服务 器 上 运行 该 程序 。 然 而 ， 从 以 云 为 核心 的 角度 看 ， 在 没有 人 工 干预 或 程序 化 干预 的 情况 下 ， 程 序 
及 其 所 有 依赖 项 从 一 个 虚拟 机 移动 到 另 一 个 虚拟 机 的 能 力 是 最 适用 的 “可 移植 性 ”。 记 住 ， 云 中 会 出 现 失败 ， 运 
行程 序 的 虚拟 机 (VMD) 可 以 在 任何 给 定 的 时 间 消 失 ， 然后 在 另 一 台 虚 拟 机 上 重新 构建 。 因此， 程序 必须 是 可 移植 
的 ， 能 从 这 样 的 事件 中 恢复 。 
“可 伸缩 性 ”意味 着 ， 当 多 个 客户 使 用 代码 时 ， 代 码 能 正常 啊 应 。 例 如 ， 如 果 每 分 钟 有 1500 个 请 求 ， 且 请 
求 的 完成 和 响应 在 1 秒 钟 之 内 完成 ， 则 大 约 每 秒 有 25 个 并 发 请 求 。 如 果 每 分 钟 有 15 000 个 请 求 ， 则 每 秒 有 250 
个 并 发 请 求 。 云 程序 能 以 相同 的 方式 响应 25 个 和 250 个 并 发 请 求 吗 ? 如 果 是 2550 个 并 发 请 求 呢 ?以 下 是 几 个 
有 效 管理 可 伸缩 性 的 云 编 程 模式 : 
e 命令 和 查询 责任 分 离 (Command and Query Responsibility Segregation，CQRS) 模 式 一 一 这 种 模式 小 
及 把 读 取 数 据 的 操作 与 修改 或 更 新 数据 的 操作 分 离开 。 
e 物化 视图 模式 一 一 这 会 修改 存储 结构 ， 以 便 反 映 数 据 查询 模式 。 例 如 ， 为 极 常用 的 查询 创建 视图 可 以 
执行 更 有 效 的 查询 。 
e 分 片 (Sharding) 模 式 一 一 这 把 数据 分 解 到 多 个 水 平 碎片 中 (其 中 包含 明显 不 同 的 数据 子 集 )， 而 不 是 通过 
增加 硬件 的 容量 进行 垂直 伸缩 。 
e 管家 钥匙 (Valet Key) 模 式 一 一 这 人 允许 客户 直接 访问 数据 存储 ， 以 传输 或 上 传 大 文件 。 它 不 是 让 Web 客 
户 机 管理 数据 存储 的 守卫 工作 ， 而 是 给 客户 提供 一 把 管家 钥匙 ， 并 人 允许 直接 访问 数据 存储 。 


这 些 模式 涵盖 一 些 高 级 的 C# 编 码 技术 ， 因 此 这 里 只 描述 模式 。 如 果 希 望 查看 实现 模式 的 实际 C# 代 码 ， 可 
在 互联 网 上 通过 搜索 找到 它们 。 


“弹性 ”是 指 程序 啊 应 和 从 服务 故障 和 异 和 当中 恢复 的 程度 。 从 历史 上 看 ，IT 基础 设施 一 直 专注 于 失败 的 预 
防 , 其 可 接受 的 停机 时 间 是 最 短 的 , 期望 值 是 99.99% 或 99.999% SLA(Service-Level Agreement, 服务 水 平 协议 )。 
但 在 云 中 运行 程序 ， 可 靠 性 需要 做 思维 转变 ， 我 们 需要 拥抱 失败 ， 要 更 关注 恢复 (而 不 是 预防 )。 程 序 有 多 个 依 
赖 项 ， 如 数据 库 、 存 储 器 、 网 络 和 第 三 方 服务 ， 其 中 一 些 没有 SLA， 所 以 需要 转变 视角 。 在 出 现 中 断 或 非 正常 
运行 的 情况 下 ， 如 果 仍 能 做 出 用 户 友 好 的 啊 应 ， 会 使 云 程序 富有 弹性 。 下 面 的 一 些 云 编程 模式 可 用 于 将 弹性 欧 
入 云 程序 : 
e 断路 病 模 式 一 一 这 是 一 种 代码 设计 方式 ， 它 了 解 远程 服务 的 状态 ， 只 有 在 服务 可 用 的 情况 下 ， 才 会 试 
图 连接 。 如 果 通 过 以 前 的 失败 知道 远程 服务 不 可 用 ， 就 会 避 倪 尝试 请 求 和 浪费 CPU 周期 。 
e 健康 痛 点 监控 模式 一 一 这 会 通过 实现 痛 点 检测 ， 检 查 基 于 云 的 应 用 程序 是 售 可 用 。 
e 重 试 模式 一 一 在 短暂 的 异常 或 故障 后 重 试 请 求 。 这 种 模式 在 给 定 的 时 间 段 内 重 试 多 次 ， 当 重 试 次 数 到 
ARER, mUER IESU X. 
e 下流 模式 一 一 管理 云 程 序 的 使 用 ， 以 便 满 足 SLA， 而 且 程序 在 高 负载 下 仍然 可 用 。 
使 用 上 述 一 个 或 多 个 模式 ， 有 助 于 更 成 功 地 实现 云 迁 移 。 上 述 模式 会 提高 程序 的 可 伸缩 性 和 弹性 ， 从 而 提 
高 程序 的 可 用 性 。 这 反 过 来 会 市 来 更 恰 悦 的 用 尸 或 客户 体验 。 
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16.3 ”使 用 Microsoft Azure C# 库 创建 存储 容器 


尽管 有 许多 云 提供 商 ， 但 用 于 本 章 和 下 一 章 中 例子 的 云 提 供 商 是 Microsoft. Microsoft 提供 的 云 平台 是 
Azure. Azure 有 许多 不 同 种 美的 特性 。 例 如 IaaS 产品 称 为 Azure VM, PaaS 产品 称 为 Azure 云 服 务 。 此 外 ， 
Microsoft 还 有 用 于 数据 库 的 SQL Azure. HT Suk Petri) Azure Active Directory、 用 于 存储 blob 的 Azure 
Storage. 


注意 : 
下 面 的 “ 试 一 试 ” 练 习 要 求 订 阅 Microsoft Azure。 如 果 尚 未 订阅 ， 可 在 http:Wazure. microsoft.com 上 注册 一 
个 30 天 期 限 的 免费 试用 版 本 。 


以 下 两 个 练习 将 创建 一 个 Azure 存储 账户 和 一 个 Azure 存储 容 右 。 之 后 ,将 使 用 Microsoft Azure Storage SDK 
for NET 将 52 张 扑克 有 牌 的 图 片 存储 到 该 容 颖 中。 下 一 市 将 创建 一 个 ASPNET 4.7 Web 站 点 ,来 访问 存储 在 Azure 
存储 容器 中 的 图 片 。 在 本 书 的 后 面 , 这 个 ASPNET 4.7 Web 站 点 将 处 理 一 手 扑克 有 牌 。 扑 克 牌 图 片 是 存储 在 Azure 
TEASE a PNY blob. 


试 一 试 ” 创 建 一 个 Azure 存储 账户 


(1) 访问 Microsoft Azure 门户 网 站 https://portal.azure.com. 
(2) 依次 单 击 + 号 、New 六 单项 和 Storage 项 ， 有 再 单 击 “Storage account — blob, file, table, queue ”选项 ， 如 图 
16-3 所 示 。 


storage >  Lreate storage account 
O x Storage 
The cost of your storage account depends on the 


usage and the options you choose below. 
Learn more 


Search the Marketplace 


MARKETPLACE FEATURED APPS See all * Mame t 


deckafcards 


Compute r, Storage account - blob, file, ————— 
i | table, | S Me Deployment model © 
Networking Use Blobs, Tables, Queues, and Files o 
Resource manager| Classic 


for reliable, economical cloud 


Storage 


Account kind 看 


Web + Mobile i General purpose 


Databases | Performance & 
: Standard | Premium 
Data « Analytics EGER! 
f Replication @ 
Al + Cognitive Services ; 
" Locally-redundant storage (LRS) 


Internet of Things 
* Storage service encryption (blobs an 


Enterprise Integration b, Disabled | Enabled 


Security + identity * Secure transfer required © 


Disabled | Enabled 


Developer tools 
* Subscription 
Monitoring « Management 
Ad mine 1 
Add Orns b Reso urce gro up a 
A D Create new @ Use existing 
Lontainers 
Beginning Sharp 


Blockchain 


* Location 


West Europe 


RECENT 


Storage account - blob, file, table 
| lied 2 
Fin to dashboard 


Function App 
x cai PP Automation options 
A 16-3 
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(3) 输入 存储 账 己 名称、 元 余 、 资 源 组 和 位 置 。 出 于 成 本 考虑 (在 试用 期 过 后 将 需要 付费 )， 考 虑 把 见 余 设置 
为 Locally redundant Storage(LRS)。 这 就 避 急 了 在 男 一 个 区 域 创建 存储 账户 的 浅 度 副本 而 之 来 的 少量 铬 外 成 本 。 
然而 在 存储 账 尸 所 在 的 同一 区 域 数 据 中 心 ， 文 件 被 复制 了 三 次 。 

(4) 一 旦 输入 名 称 、 宛 余 、 资 源 组 和 位 置 ， 就 单 击 Create 按钮 ， 此 时 将 看 到 如 图 16-4 所 示 的 屏幕 。 在 这 个 
例子 中 ，Azure 存储 账户 是 deckofcards. Z3 Azure 存储 账户 指定 另 一 个 名 称 。 记 住 该 名 字 ， 因 为 它 要 用 于 下 一 
个 “ 试 一 试 ” 练 习 。 

(5) 这 样 就 成 功 创建 了 一 个 Azure 存储 账户。 


存储 账户 可 用 于 存储 blob、 表 、 队 列 和 文件 。 例 子 包 括 数据 库 备份 、Azure Web App IS 日 志 、VM 机 器 映 
像 、 文 档 或 图 片 ， 每 个 存储 账户 最 多 可 存储 100TB 数据 。 


十 Add @ AssignTags S8 Columns eo Refresh M Delete 


P, Storage accounts and Storage accounts (classic) can now be managed together in the combined list below. 


Subscriptions: 1 of 6 selected - Dont see a subscription? Switch directories 


deckofcards v All resource groups v All types v All locations 


No grouping 


| | NAME ™“ TYPE ^- KIND `“ RESOURCE GROUP ~ LOCATION ~ SUBSCRIPTION ~ 


= deckofcards Storage account Storage BeginningCSharp West Europe 


图 16-4 


示例 说 明 

Microsoft Azure 害 理 控制 台 本 身 运行 在 PaaS 云 服务 模型 ( 即 Azure 云 服 务 ) 的 Microsoft Azure FS E. 管理 
控制 人 台 由 Microsoft 的 一 个 产品 团队 编写 ， 由 Microsoft 文 持 人 员 文 持 。 左 边 导 航 栏 上 的 所 有 特性 都 可 供 创 
建 和 利用 。 用 日 己 的 订阅 创建 一 个 Azure 存储 账户 ， 就 可 以 获得 存储 空间 和 一 个 全 局 可 访问 的 URL， 进 而 
访问 存储 账户 deckofcards 的 内 容 ( 例 如 https://deckofcards.blob.core.windows.net). 


试 一 试 ” 使 用 Microsoft Azure Storage Client Library 创建 Azure 存储 容器 


下 面 将 使 用 Visual Studio 2017 和 Microsoft Azure Storage Client 库 来 创建 一 个 控制 台 应 用 程序 ， 从 而 创建 一 
个 Azure 存储 容器 ， 并 给 它 上 传 52 Kh 

(1) 在 Visual Studio 中 选择 File | New | Project， 创 建 一 个 新 的 控制 台 应 用 程序 项 目 。 在 Add New Project 对 
话 框 (参见 图 16-5) 中 ,选择 类 别 Visual C£, 然后 选择 Console App (.NET Framework) fei, 把 项 目 命名 为 Chl16Ex01 
并 保存 在 C:\BeginningCSharp7\Chapterl6 目录 下 。 


b Recent 
4 Installed 
4 Visual Cf 
Windows Universal 
Windows Classic Desktop 
Web 


.NET Core 
.NET Standard 


b Other Languages 
Not findinn what vou are lonkinn fort — 
P Online 


Ch16Ex01 


NET Framework 4.7 - Sort by: Default 


esi WPF App (NET Framework) Visual C# 
mate 

| | Windows Forms App (NET Framework) Visual C+ 
页 Console App (NET Core) Visual C# 


Console App (.NET Framework) Visual Cs 


ce 
A Class Library (.NET Standard) Visual C# 


E 
A Class Library (NET Framework) Visual C£ 
L 


ol ASP.NET Web Application (NET Framework) Visual C# 


i 1 ^ BED MET Cara Wek Annli^atinn / MET Carai Vieial (Cat 


CABeginningCSharp /Chapter16 
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了 ii =| Search Installed Templates (Ctri+ P- 


^ Type: Visual C# 


A project for creating a command-line 
application 


| 371 


(2) 右 击 Ch16Ex01 | Add... | New Folder, 给 项 目 添加 一 个 名 为 Cards 的 目录 。 把 52 sth si E18 PLE ESI BU] 
该 目录 中 ， 如 图 16-6 所 示 。 图 片 可 从 源 代码 下 载 站 点 中 获得 ， 分 别 命 名 


Solution Explorer AE 


ood- o- seat pje 


， 从 0-1.PNG 到 3-13.PNG. 


X 


Search Solution Explorer (Ctrl «:) p- 


4 « Chapterl6 
P Ch16Ex01 
b e Properties 
b =E References 


F3 0-1,PNG 
图 0-10PNG 
图 0-11.PNG 
器 0-12.PNG 
FS 0-13.PNG 
图 0-2.PNG 
F3 0-3.PNG 
F3 0-4.PNG 
F5 0-5.PNG 
FẸ 0-6.PNG 
图 0-7.PNG 
F5 0-8.PNG 
FA 0-9PNG 
FS 1-1.PNG 
FH 1-10.PNG 
图 1-11.PNG 
Solution Explorer Team Explorer Class View 
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i. 


(3) 此外， 把 Cards 目录 复制 到 C:\BeginningCSharp7\Chapter16\Ch16Ex01\bin\Debug 下 ， 这 样 在 运行 时 ， 编 


详 后 的 可 执行 文件 可 以 找到 它们 。 


(4) 再 次 右 击 Ch16Ex01 项 目 ， 从 弹出 的 玉音 中 选择 Manage NuGet Packages... 
(5) 在 如 图 16-7 所 示 的 搜索 文本 框 中 ， 输 入 Microsoft Azure Storage， 安 装 WindowsAzure.Storage 客户 端 库 。 有 
X Windows Azure Storage 库 的 更 多 信息 , 可 在 https://docs.microsoft.com/en-us/dotnet/api/overview/azure/storage?view 


=azure-dotnet 上 找到 。 
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99) Beginning Sharp? - Micresert Visual Studio 
Fle Edt view Project Build Debug Team Tools Test Analyze Window Help 
E- oH Debug = Any CPU = (ChlGExDT “| b sat- M; 


; (Nuet Chie! = < |.  ) | | AJ... . — — . . .  . . —  . teolution Explorer - n x 


— IPM T E 
wee Installed Updates NuGet Package Manager: Ch16Ex01 LLL. E 

Cearch Solution Explorer (Ciis = 
Microsoft Arwe Storage X > (à [O incude prerelease Package source: | nugetorg - #2 fa! Solution ‘Beginning’ Sharp? (44 projects 
E Chapteriz 
E Chapterfa 
E Chapter 
E Chapterüs 
B ChapterDé 
E Chapterl? 
a 
= 


m WindowsAzure.Storage 


WindowsAzure.Storage by Microsoft, 11.8M downloads 
LS A client library Tar working with Microsoft Azure storage services including blobs, 
files, tables, and queues. Veron: Latest table &.2 0 
Chapters 
Chapters 
E Chapter 
@ Chapter1i 
E Chapteri? 
© Chapterii 


(**) Options 


Deseriptlon 
This client library enables working with the Microsoft Azure storage senrices which inchude the 
E = Lhapgteri6 

blab and file samice for storing canary and text data, the table service for stonng structured z 

non-relabional data. amd the queue service for storing messages that may be accessed by a 4 (5 m 

client bog Properties 
For this relemea zee nates - httec//githubeom) A rure/azune -storage-nat/blobmaster/ bo "" References 

README. mg and https; gitub.com/ Azure/azune-storage -net/blob/ master'changelog txt b HE Cadi 
Microsofr Azure Storage team's blog = hrtpc/ blogs midn com/ b) windewsazurestorage/ € Appconfig 


k "oue uou US Cou Coco YF 


b €* Programa 
BD ae sie 
b E4 Beginning? Sharp? 
Microsoft 
hifgc) 'ge.mieresatt.com hadini ibd 131471 1 k 


: Friday, Mly 14, 2017 (7/14/2017) Solution Explor... Team Explorer Class View 


* CLA Properties hi X 
http /ge.mieresaft.comyTwdinky?7L inkhda 235 1 08 Properties * 
nit ps, Pane nugetorng/ packages "Windcwsbrure SAormgeB 2 D/Repart buses : 
BE UE 
Tabie, Azure, Storage, Microsoft, File, Scalable, Queue, Blok, i 
winedewranaeotteial 


JANET Standard. Version v1.0 
Mücrasatt Data Data (re 5842) 
Each package is licensed to you Ey ims owner. NuGet is mot responsible for, nàr does it grant ang licenses *ystem. Spatial (== 3.1.7) 
in, third-party packages. Mewtonsoft ken (>= 90.1) 
NETStandarc Library (>= 180) 


| Do not show tihi 
[ not s 5 again WindecwsPhone App, Version - vit 


Error list. Ouiput Fund Symbol Results  Breakpeints Call Hierarchy Web Publish Aetnaty 
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(6) RAP PM, — H. ag NuGet BRAM, MTE Visual Studio Hih fi LEUR] “======= 
—-------FPnished----—---—---—--—-—-—-—-—" JAR. Wb, Chl6Ex01 内 的 References 文件 夹 展 开 了 了 ， 
BY TEP EA SES IER] — ee il] SOF 

(7) 打开 App.config 文件 ， 将 以 下 <appSetting> 设 置 添 加 到 <configuration> 部 分 。 注 意 在 前 和 面 的 “ 试 一 试 ” 
练习 (deckofcards) 中 , AccountName 是 前 面 创 建 的 Azure 存储 账户 的 名 称 。 应 把 它 改 为 目 己 的 Azure 存储 账户 名 。 
获得 AccountKey 的 步骤 可 参考 步骤 (8)。 

<appSettings> 

<add key-"StorageConnectionString" 
value="DefaultEndpointsProtocol=https; AccountName=NAME; 
AccountKey-REY" /> 

</appSettings> 

(8) 为 获得 Azure 存储 账户 密 钥 和 连接 字符 串 ， 应 访问 Microsoft Azure E) ] P (https://portal.azure.com), 
导航 到 Azure 存储 账户 。 如 图 16-8 所 示 ， 在 SETTINGS 部 分 有 一 项 Access keys。 选 择 该 项 ， 复 制 key] 的 连接 
字符 串 ， 将 其 放 入 App.config 文件 ， 作 为 value 值 。 


ec k yh or Js 


» X 


se? Wide D Search ice ‘Al +] 

Use access keys to authenticate your applications when making requests fo this Azure storage account. Store your 

access keys securely = for example, using Azure Key Vault = and don't share them. We recommend regenerating your 
mm Overview access keys regularly. You are provided two access keys so that you can maintain connections using one key while 
Storage accounts and Storage 
accounts (classic) can now be 
managed together in the combined Bh Activity log 
list below. 


regenerating the other 


When you regenerate your access keys, you must update any Azure resources and applications that access this 
" storage sccount to use the new keys. This action will not interrupt access ta disks from your virtual machines. Learn 
mad Access contre (LAM) | 
i marë 
Subscriptions: | of 6 selected = Don't see a Ed Tags 7 
subscription? Switch directories Storage account name deckofcands 


hr * Diagnose and solve problems 


Default keys 


1 items 
SETTINGS MAME CONNECTION STRING 


NAME 
T Access keys 


DefaultEndpaintsProtocol https... Q 


@ Configuration DefaultEndpointsProtocol -https.... v | 
a Shared acoess signature 


国 deckofcards 


I|! Properties 
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(9) 现在 添加 代码 来 创建 容器 ， 上 传 图 片 ， 列 出 它们 ; 如 有 必要 ， 可 删除 它们 。 首 先 在 Main0 方 法 中 添加 
程序 集 引 用 和 CHEX try {}...catch { }， 如 下 所 示 : 


using System; 

using System. IO; 

using System.Configuration; 

using Microsoft.WindowsAzure; 

using Microsoft.WindowsAzure. Storage; 
using Microsoft.WindowsAzure.Storage.Auth; 
using Microsoft.WindowsAzure.Storage.Blob; 
using static System.Console; 


namespace Chl6Ex01 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
try i] 
catch (StorageException ex) 
{ 
WriteLine($"StorageException: {ex.Message}"); 
catch (Exception ex) 
{ 
WriteLine ($"Exception: {ex.Message}"); 
} 
WriteLine ("Press enter to exit."); 
ReadLine (); 
} 
} 
} 


(10) BERR, FE try 人 代码 块 中 添加 创建 容器 的 代码 ， 如 下 所 示 。 看 看 传递 给 blobClient.GetContainer- 
Reference("carddeck") 的 参数 carddeck。 这 是 用 于 Azure 存储 容器 的 名 称 。 此 后 可 通过 https://deckofcards.blob. 
core.windows.net/carddeck/0-1.PNG bg 问 这 个 容 吉 的 内 容 。 例 如 ， 可 在 其 中 放置 任何 想 要 的 名 称 ， 只 要 符合 ia 
要 求 即 可 (例如 ， 名 称 的 长 度 必 须 是 3-63 个 字符 ， 必 须 以 字母 或 数字 开头 )。 如 果 提 供 的 容器 名 称 不 符合 
求 ， 束 返回 400 HTTP DAE. di Reference — 然后 选择 Add Reference... | Assemblies | diii 
System.Configuration ， 并 单 击 OK 按钮 ， 添 加 对 System.Configuration.dll 程序 集 的 引用 。 


CloudStorageAccount storageAccount = CloudStorageAccount. Parse ( 
ConfigurationManager.AppSettings ["StorageConnectionString"]); 

CloudBlobClient blobClient = storageAccount.CreateCloudBlobClient (); 
CloudBlobContainer container = blobClient.GetContainerReference ("carddeck"); 
if (container.CreateIfNotExists()) 
{ 

WriteLine(S"Created container '[container.Name]' " + 

s"in storage account '{storageAccount.Credentials.AccountName}'."); 
} 
else 
{ 

WriteLine($"Container '{container.Name}' already exists " + 

s"for storage account 'í(storageAccount.Credentials.AccountName]'."); 
} 
container.SetPermissions (new BlobContainerPermissions 
{ PublicAccess = BlobContainerPublicAccessType.Blob }); 
WriteLine($"Permission for container '{container.Name}' is public."); 


(11) 把 如 下 代码 添加 到 步骤 (10) 中 创建 容器 的 代码 的 后 面 ， 这 些 代 码 会 上 传 存储 在 Cards MPFR PHISH và 
牌 图 片 : 


int numberOfCards = 0; 
DirectoryInfo dir - new DirectoryInfo(8"Cards"); 
foreach (FilelInfo f in dir.GetFiles("*.*")) 


CloudBlockBlob blockBlob - container.GetBlockBlobReference(f.Name); 
using (var fileStream = System.I0.File.OpenRead (@"Cards\" + f.Name)) 


blockBlob.UploadFromsStream(fileStream); 
WriteLine($"Uploading: '{f.Name}' which " + 
5"15 {fileStream.Length} bytes."); 

} 

numberOfCards++; 
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} 
WriteLine($"Uploaded {numberOfCards.ToString()} cards."); 


WriteLine(); 
(12) EH Efe. Ae BIER. CERO DIS Za YS PER AS, JUTE STEN Azure 
存储 容器 carddeck 中 的 blob. 


numberofCards = 0; 
foreach (IListBlobItem item in container.ListBlobs(null, false)) 


if (item.GetType() == typeof (CloudBlockBlob) ) 

{ 

CloudBlockBlob blob = (CloudBlockBlob) item; 

WriteLine ($"Card image url '{blob.Uri}' with length ™ + 
o" of {blob.Properties.Length}"); 


] 
numberoOfcCards4-; 


} 
WriteLine($"Listed [numberOfCards.ToString()) cards."); 


(13) 现在 ， 如 有 必要 ， 可 删除 刚 上 传 的 图 片 。 下 例 展示 了 如 何以 编程 方式 删 际 容器 中 的 blob 文件 : 


WriteLine ("Enter Y to delete listed cards, press enter to skip deletion:"); 
if (ReadLine() == "v") 
{ 
numberOfCards = 0; 
foreach (IListBlobItem item in container .ListBlobs (null, false)) 
{ 
CloudBlockBlob blob = (CloudBlockBlob) item; 
CloudBlockBlob blockBlobToDelete = container.GetBlockBlobReference (blob.Name); 
blockBlobToDelete.Delete(); 
WriteLine($"Deleted: '{blob.Name}' which was {blob.Name.Length} bytes."); 
numberOfCards++; 
} 
WriteLine($"Deleted {numberOfCards.ToString()} cards."); 
} 


(14) 运行 控制 台 应 用 程序 并 查看 输出 ， 结 果 如 图 16-9 所 示 。 然 后 访问 Microsoft Azure 管理 控制 台 ， 查 看 
新 建 容器 carddeck 的 页 面 ， 如 图 16-10 所 示 。 单 击 容器 ， 查 看 其 内 容 。 


Dytes 
D Les 
Dytes 
Dytes 
bvtes 
Dytes 
Dyles 
byte 


图 16-9 
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Blob service endpalint 
https;//deckofcards.blobaorewindows.net 
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示例 说 明 

可 通过 编程 方式 创建 Azure 存储 账户 ， 但 这 种 创建 方式 的 安全 方面 相对 复杂 ， 访 步骤 是 直接 在 Microsoft 
Azure 官 理 控制 台 上 执行 的 。 创 建 一 个 Azure 存储 账户 后 ， 束 可 以 在 该 账户 内 创建 多 个 容 左 。 在 本 例 中 ， 创 建 
了 一 个 名 为 carddeck HJA 4r. BES Microsoft Azure 订阅 的 存储 账 己 数量 是 有 限 的 ， 而 存储 账 己 内 的 容 费 数量 没 
有 限制 。 可 以 创建 任意 多 个 容 右 ， 但 要 注意， 每 个 容 右 部 是 有 成 本 的 。 

本 例 的 代码 分 为 4 部 分 (创建 容器 ， 把 图 片上 传 到 容器 ， 列 出 容器 中 的 blob, 根据 需要 有 选择 性 地 删除 容器 
的 内 容 )。 执 行 的 第 一 步 是 为 控制 台 应 用 程序 建立 try{ )...catch( } 框 架 。 这 是 一 种 很 好 的 实践 方式 ， 因 为 未 捕获 
或 未 处 理 的 异 弟 通常 会 使 过 程 (EXE) 骨 尝 ， 而 这 忆 是 应 该 避 倪 的。 第 一 个 catch0 表 达 式 是 StorageException, 捕获 
在 Microsoft. WindowsAzure.Storage 名 称 空间 的 方法 中 专门 抛 出 的 异 第 。 


catch (StorageException ex) 
然后 有 一 个 捕获 所 有 寞 肖 的 表达 式 ， 处 理 所 有 其 他 意 想 不 到 的 异 肖 ， 并 把 异常 消 居 写 到 控制 台 。 
catch (Exception ex) 


ty 和 代码 块 内 的 第 一 行 代码 使 用 添加 到 App.config 文件 中 的 细节 来 创建 Azure 存储 账户 。 


CloudStorageAccount storageAccount = CloudStorageAccount. Parse ( 
ConfigurationManager .AppSettings ["StorageConnectionString"]); 


App.config 文件 包含 在 Azure FF fig IK ^ ERATE ERBRTE P m IT IKA A IK EH. PP OR, 61 
Ee PE, ELE KP AEE blob 容器 的 接口 。 然 后 代码 获得 特定 容器 carddeck 的 引用 。 
CloudBlobClient blobClient = storageAccount.CreateCloudBlobClient (); 


CloudBlobContainer container = 
blobClient.GetContainerReference ("carddeck"); 


接 下 来 调用 container.CreateIfNotExists)/7X. WREE T Ai HATES CAPE, RI tme 值 ， 
JAR SARHA. Al, MRABCAF, BUR) false. 


if (container.CreateIfNotExists()) 


{- ++. 
容器 可 以 是 Private 或 Public。 对 于 这 个 示例 ， 容 器 是 Public， 这 意味 着 不 需要 访问 密 钥 ， 就 可 以 访问 它 。 执 
行 下 面 的 代码 ， 就 可 以 把 容器 设置 为 public: 


container.SetPermissions(new BlobContainerPermissions 
{ PublicAccess = BlobContainerPublicAccessType.Blob }); 


现在 创建 了 容器 ， 并 可 以 公开 访问 ， 但 它 是 空 的 。 使 用 像 DirectoryInfo 和 FileInfo 这 样 的 System.IO 方法 ， 可 
以 创建 一 个 foreach 循环 ， 把 每 张 扑 殉 牌 图 片 添 加 到 carddeck 存储 容器 中 。GetBlockBlobReference0 方 法 用 于 为 
要 添加 到 容器 中 的 特定 图 片 名 称 设 置 引 用 。 然 后 System.IO File.OpenRead0 方 法 利用 文件 名 和 路 径 ， 将 实际 文件 
打开 为 FileStream， 并 通过 UploadFromStream0 方 法 上 传 到 容器 中 。 


CloudBlockBlob blockBlob = container.GetBlockBlobReference(f.Name); 


376 | 第 咱 部 分 BABLARE 


using (var filestream = System.IO.File.OpenRead (@"Cards\" + f.Name)) 


{ 
blockBlob.UploadFromStream (fileStream) ; 
} 


JAK Cards AR PIN PTA CHE, FREER Aas. ERATE carddeck 容器 的 初始 创建 过 程 中 创建 的 同一 个 容器 
对 象 ， 通 过 调用 ListBlob0 方 法 ， 把 现 有 的 一 组 blob 返回 为 IEnumerable<IListBlobItems>。 然 后 明 历 列表 ， 把 它 
们 写 到 控制 从。 

foreach (IListBlobItem item in container.ListBlobs(null, false)) 

‘it (item.GetType() == typeof (CloudBlockBlob) ) 

udis blob = (CloudBlockBlob)item; 

WriteLine($"Card image url '{blob.Uri}' with length of " + 

$" {blob.Properties.Length}") ; 

nunberofcardstt 

如 前 所 述 , 许多 类 型 的 项 都 可 存储 在 容器 中 ,例如 blob、 表 、 队 列 和 文件 。 因 此 , 在 把 项 以 CloudBlockBlob 
类 型 装 箱 之 前 , 一 定 要 确认 该 项 是 CloudBlockBlob 类 型 。 其 他 要 检查 的 类 型 是 CloudPageBlob 和 CloudBlobDirectory - 

要 删除 容器 中 的 blob， 当 遍历 它们 并 写 到 控制 台 时 ，blob 列表 的 检索 方式 要 与 以 前 的 相同 。 删 除 它 们 时 的 
区 别 是 调用 GetBlockBlobReference(blob Name) 以 获得 特定 blob 的 引用 ， 然 后 为 该 blob 调用 Delete0 方 法 。 


CloudBlockBlob blockBlobToDelete = container.GetBlockBlobReference (blob.Name); 
blockBlobToDelete.Delete(); 


现在 创建 了 Azure 存储 账户 和 容器 ， 加 载 了 52 skh och AA, BPrEARTELGUZE— ^ ASP.NET 网 站 来 引用 
Azure 存储 容器 了。 


16.4 ”创建 使 用 存储 容器 的 ASP.NET 4.7 网 站 


到 目前 为 止 ， 还 没有 深入 探讨 什么 是 Web 应 用 程序 ， 也 没有 讨论 ASPNET 的 基本 方面 。 本 节 提 供 了 一 些 
洞察 这 些 技术 的 视角 。 

Web 应 用 程序 让 Web ARS a In] eg? 9j AIA HTML 代码 .这些 代 码 显 示 在 Web 浏览 左上 ,例如 Microsoft Edge 
或 Google Chrome。 当 用 户 在 浏览 右 中 输入 URL 字符 串 时 ，HTTP ok 2 13 IKE] Web 服务 器 。HTTP 请 求 包 
舍 所 请 求 的 文件 名 和 其 他 信息 , 比如 识别 应 用 程序 的 字符 串 、 客 户 痛 文 持 的 语言 以 及 属于 请 求 的 其 他 数据 。Web 
服务 器 返回 一 个 包含 HTML 代码 的 HTTP 啊 应 ， 这 些 代 码 由 Web 浏览 右 解 释 ， 回 用 户 显示 文本 框 、 按 钮 和 
列表 。 

ASP.NET 是 一 种 用 服务 右 端 代码 动 态 创建 Web 页 面 的 技术 。 这 些 Web 页 面 的 开 友 方式 与 客户 朵 Windows 
程序 具有 诸多 相似 之 处 。 如 果 不 直 接 处 理 HTTP 请 求 和 啊 应 ， 手 动 创建 友 送 到 客户 病 的 HTML 代码 ， 还 可 以 使 
用 创建 HTML 代码 的 控件 ， 例 如 TextBox. Label. ComboBox 和 Calendar. 

Aen FP lin AEN Web 应 用 程序 使 用 ASPNET, 只 震 要 一 个 简单 的 Web 浏览 器 。 可 使 用 Internet Explorer. 
Microsoft Edge. Google Chrome. Firefox 或 其 他 任何 支持 HTML 的 Web 浏览 器 。 客 户 凯 系统 不 需要 安装 NET。 

在 服务 右 系 统 上 ， 击 要 ASPNET 运行 库 。 如 果 系 统 上 有 IS, ZANET Framework 时 就 会 用 服务 器 配置 
ASPNET 运行 库 。 在 开发 期 间 ， 不 需要 使 用 IS， 因 为 Visual Studio 提供 了 自己 的 ASPNET Web 开发 服务 器 ， 
可 以 用 它 测试 和 调试 应 用 程序 。 

为 理解 ASP.NET 运行 库 是 如 何 工作 的 ， 考 虑 一 个 来 日 浏览 器 的 典型 Web 请 求 ( 见 图 16-11). FP vain Fy HR 
器 请 求 一 个 文件 ， 如 default.aspx 或 default.cshtml。ASPNET Web 窗 体 页 面 通常 的 文件 扩展 名 是 .aspx( 尽 管 ASPNET 
MVC 没有 特定 的 文件 扩展 名 )， 而 .cshtml 用 于 基于 Razor 的 网 站 。 因 为 这 些 文件 的 扩展 名 用 DIS 注册 ， 或 者 
ASPNET Web 开发 服务 器 能 识别 它们 ， 所 以 ASPNET 运行 库 和 ASPNET 工作 进程 会 启动 。IS 工作 进程 被 命 
名 为 w3wp.exe， 驻 留 在 Web 服务 器 的 应 用 程序 上 。 第 一 次 请 求 default.cshtml MY, JH2/ ASPNET 解析 器 ， 编 译 
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器 编译 文件 和 C# 代 码 ， 这 些 C# 代 码 与 .cshtml 文件 相关 ， 并 创建 一 个 程序 集 。 然 后 .NET 运行 库 的 JIT 编译 器 
把 程序 集 编译 为 本 机 代码 。 之 后 销毁 Page 对 象 。 但 程序 集 保留 下 来 ,用 于 后 续 请 求 ， 所 以 没 必要 再 次 编译 程 


图 16-11 
基本 理解 Web 应 用 程序 和 ASPNET 后 ， 就 可 以 执行 下 例 中 的 步骤 了 。 
试 一 试 ”创建 一 个 ASP.NET 4.7 网 站 来 处 理 两 手 扑 克 牌 


下 面 再 次 使 用 Visual Studio 2017， 但 这 次 要 创建 一 个 ASPNET 网 站 ， 请 求 两 个 玩家 的 名 字 ， 然 后 在 提交 
TAY, AEAF Sh eh. 1x61 ERM ZB EA Azure 存储 容器 下 载 ， 扑 殉 牌 显示 在 Web 页 面 上 。 

(1) 在 Visual Studio 中 选择 File | New | Web Site...， 创 建 一 个 新 的 Web Site 项 目 。 在 New Web Site 对 话 框 ( 见 
16-12) 中 ， 选 择 Visual C# 类 别 ， 然 后 选择 ASPNET Empty Web Site 模板 。 将 网 站 命名 为 Ch16Ex02。 


b Recent NET Framework 4.7 ~ Sort by: Default - Tm := Search Installed Templates (Ctrl+ 49 ~ 


4 Installed + "ER 
ASP.NET Empty Web Site Visual C# Type: Visual C# 


4 Templates An empty Web site 
Visual C# ASP.NET Web Forms 5ite Visual C# 
Visual Basic 
ASP.NET Web Site (Razor v3) Visual Cs 
Not finding what you are looking for? > 
Open Visual Studio Installer ASP.NET Dynamic Data Entities Web Site Visual C# 


b Online i 
» WCF Service Visual C# 


Web location File System - (ABeginningCSharp/XChapterl6XChT6Ex02 


16-12 


(2) Ad Ch16Ex02 解决 方案 ， 然 后 选择 Add | Add ASPNET Folder | App Code， 添 加 一 个 ASPNET 文件 夹 
App Code。 
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(3) 从 下 载 站 点 下 载 示 例 代码 ， 并 将 下 面 的 类 文件 放 在 刚 创 建 的 文件 夹 App Code P. FRH, Atr 
App Code 文件 来 ， 选 择 Add | Existing Item...， 并 从 下 载 的 示例 中 选择 以 下 7 个 类 。 

a. Card.cs 

b. Cards.cs 

c. Deck.cs 

d. Game.cs 

e. Player.cs 

f. Rank.cs 

g. Suit.cs 


步骤 (3) 中 的 类 非常 类 似 于 以 前 例子 中 使 用 的 类 。 只 进行 了 少量 调整 ， 如 移 除 WriteLine0、ReadLine0 方 法 
和 一 些 未 使 用 的 方法 。 在 Cards 类 中 有 一 个 新 的 构造 函数 ， 其 中 包含 到 扑克 牌 图 片 的 链接 。 


(4) 右 击 CH16Ex02 解决 方案 ， 然 后 选择 Add New Item... | Visual CZ | Empty Page (Razor v3)， 如 图 16-13 
所 示 ， 给 项 目 添 加 一 个 Razor v3 文件 default.cshtml。 


4 Installed : Default 


Search Installed Templates (Ctri-- E. P - 
Visual Basic Web Form Visual C# Type: Visual C& 
Visual C# Empty Page with Razor syntax (CSHTML) 
b Online n Content Page (Razor v3) Visual Cs 
Empty Page (Razor v3) Visual C# 
Helper (Razor v3) Visual C# 
Laycut Page (Razor v3) Visual C# 
Web Page (Razor v3) Visual C# 


Master Page Visual C# 


Web User Control Visual C$ 


default.cshtml Place code in separate file 


Select master page 


«Cae | 


图 16-13 


(5) 打开 default.cshtml 文件 ， 将 下 面 的 代码 放 在 页 面 的 顶部 : 


| 
Player[] players = new Player[2]: 
var playerl = Request["PlayerNamel"]; 
var player2 = Request["PlayerName2"]; 
if (IsPost) 
{ 
players[0] = new Player(playerl); 
players[1] = new Player(player2); 
Game newGame = new Game(); 
newGame .SetPlayers (players); 
newGame .DealHands (); 
} 
} 


(6) 接 下 来 ,在 步骤 (3) 添 加 的 代码 之 后 添加 如 下 语法 。 密 切 关 注 @card.imageLink， 这 十 给 Card 类 新 添加 的 
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<!DOCTYPE html> 
«html lang="en"> 
<head> 
«meta charset-"utf-8" /> 
<style> 
body {font-family:Verdana; margin-left: 50px; 
margin-top: 50px; } 
div {border: lpx solid black; width:40$; 
margin:1.2em;padding:1lem;] 
</style> 
<title>BensCards: a new and exciting card game. </title> 
</head> 
<body> 
@if (IsPost) { 
<label id="labelGoal">Which player has the best hand.</label> 
<br /> 
<div> 
<p><label id="labelPlayerl">Playerl: @playerl</label></p> 
@foreach (Card card in players [0] .PlayHand) 
{ 
<img width="75px" height-"100px" alt-"cardImage" 
src= 
"https: //deckofcards.blob.core.windows .net/carddeck/@card 
.imageLink" /> 
} 
</div> 
<div> 
<p><label id="labelPlayerl">Player2: @player2</label></p> 
@foreach(Card card in players[1] .PlayHand) 
{ 
<img width="75px" height-"100px" alt-"cardImage" 
Src- 


"https://deckofcards.blob.core.windows.net/carddeck/(card 
.imageLink" /» 
} 
</div> 
} 
else 
{ 
<label id="labelGoal"> 
Enter the players name and deal the cards. 
</label> 
<br /><br /> 
<form method="post"> 
<div> 
<p>Player 1: @Html.TextBox ("PlayerNamel") </p> 
<p>Player 2: @Html.TextBox ("PlayerName2") </p> 
<p><input type="submit" value-"Deal Cards" 
class="submit"></p> 
</div> 
</form> 
} 
</body> 
</html> 


(7) 现在 ， 按 F5 功能 键 或 Visual Studio 中 的 Run 按钮 ， 运 行 Web 站 点 。 浏 览 器 将 启动 ， 显 示 如 图 16-14 
所 示 的 页 面 。 首 先 提 示 输 入 玩家 的 名 字 。 输 入 任意 两 个 名 字 。 
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[5 BensCards:anewan x & | 


> € |D localhost:49371/default.cshtm! 


Enter the players name and deal the cards. 


Player 1: 


Player 2: 


Deal Cards | 


图 16-14 


(8) itt Deal Cards 按钮 ， 给 每 个 玩家 发 一 手 牌 。 结 果 如 图 16-15 所 示 。 
前 面 使 用 Razor v3 创建 了 一 个 简单 的 ASPNET Web Site。 将 这 个 ASP.NET Web Site 连接 到 Azure 存储 
账户 和 容器 ， 以 显示 扑克 牌 的 图 片 。 


[4 BensCards: a new an x \& 1 


ée > Q [D localhost:49371/default.cshtml 


Which player has the best hand. 


Playeri: Benjamin 


T ; 

aa | 
* 

* vi 


Player2: Rual 


图 16-15 


示例 说 明 
上 例 使 用 了 名 为 Razor 的 新 技术 。Razor 是 Visual Studio 2013 与 ASPNET 3 MVC 引入 的 视图 引擎 。Razor 
使 用 类 似 C# 的 语言 (也 文 持 VB)， 这 些 语言 的 代码 放 在 @ {..} 代 码 块 中 ， 在 浏览 器 请 求 页 面 时 编译 和 执行 。 看 


看 下 面 这 段 代码 : 
ei 


Player[] players = new Player[2]; 
var playerl = Request["PlayerNamel"]; 
Var player2 = Request ["PlayerName2"]; 


if (IsPost) 

{ 
players[0] = new Player (playerl); 
players[1] = new Player(player2); 
Game newGame = new Game(); 
newGame.SetPlayers (players); 
newGame .DealHands (); 


} 
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代码 封装 在 一 个 @1{...} 代 码 块 中 ， 在 访问 时 由 Razor 引擎 编译 和 执行 。 访 问 该 页 面 时 ， 创 建 Player[] 类 型 
的 数组 ， 并 把 查询 字符 串 的 内 容 填充 到 两 个 变量 playerl 和 player2 中 。 如 果 页 面 没有 回 送 ， 就 意味 着 只 请 求 页 
面 (GET)， 而 不 是 单 击 按钮 (POST)， 于 是 不 执行 这 IsPosb 全 代码 块 内 的 代码 。 如 果 对 页 面 的 请 求 是 一 个 POST, 
在 单 击 Deal Cards 按钮 时 就 会 执行 POST， 实 例 化 Players， 开 始 新 的 游戏 ， 给 玩家 发 一 手 牌 


第 一 次 请 求 default.cshtml 文件 时 ， 会 执行 如 下 代码 路 径 ， 因 为 它 不 是 一 个 POST。 


else 
{ 
<label id="labelGoal"> 
Enter the players name and deal the cards. 
</label> 
«br /»«br /> 
«torm method-"post"» 
<div> 
<p>Player 1: @Html.TextBox("PlayerNamel") </p> 
<p>Player 2: @Html.TextBox ("PlayerName2") </p> 
<p><input type="submit" 
value-"Deal Cards" 
class-"submit"- 
</p> 
</div> 
</form> 
} 


下 面 的 代码 显示 两 个 HTML 文本 框 控件 (用 于 请 求 玩 家 的 名 字 ) 和 一 个 按钮 。 一 旦 输入 信息 , 就 单 击 Deal Cards 


按钮 以 执行 POST 和 随后 的 代码 路 径 。 代 人 码 人 遍历 每 个 游戏 玩家 的 有 牌 。 


@if (IsPost) 
{ 
«label id="labelGoal">Which player has the best 
hand.</label> 
«br /> 
<div> 
<p><label id="labelPlayerl">Playerl: 
@playerl</label></p> 
@foreach (Card card in players[0].PlayHand) 
i 
«img width="75" 
height-"100" 
alt-"cardImage" 


src= 
"https: //deckofcards.blob.core.windows .net/carddeck/@card 
.imageLink" /> 


} 
</div> 
<div> 
<p><label id-"labelPlayerl"»Player?: 
@player2</label></p> 
@foreach (Card card in players[1] .PlayHand) 
{ 


<img width="75" 
height="100" 
alt="cardimage" 
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src= 
"https: //deckofcards.blob.core.windows.net/carddeck/@card 
.imageLink" /> 


</div> 


} 
注意 ， 在 两 个 foreach 循环 里 ， 引 用 了 Azure 存储 账户 URL 和 前 和 面 练 习 中 创建 的 容器 。 


注意 : 
Azure 存储 账户 URL 和 容器 只 是 例子 。 应 该 用 自己 的 Azure 存储 账户 替换 deckofcards， 用 自己 的 Azure 存 
储 容 器 替换 carddeck. 


165 ”习题 


(1) 玩 纸牌 游戏 时 ， 需 要 在 浏览 器 和 服务 器 之 间 传 送 什么 信息 ? 
(2) 因为 Web 应 用 程序 是 无 状态 的 ， 请 说 出 存储 这 些 信息 的 一 些 方法 ， 使 它们 可 包含 在 Web 请 求 中 。 
附录 A 给 出 了 习题 答案 。 


166 ”本 章 要 点 


t dH 要 A 
定义 云 云 是 一 个 商品 化 的 、 具 有 弹性 的 计算 机 硬件 结构 ， 用 于 运行 程序 。 在 混合 云 、 公 共 云 或 私有 云 中 ， 这 些 
程序 可 在 IaaS、Paas 或 SaaS 服务 模型 上 运行 
定义 云 优 化 堆栈 云 优 化 堆栈 是 一 个 概念 , 指 代码 吞吐 量 高 ， 占 用 空间 小 , 可 与 其 他 应 用 程序 一 起 运行 在 同一 台 服 务 器 上 ， 
并 支持 跨 平台 
创建 存储 账户 存储 账户 可 包含 数量 不 限 的 容器 。 存 储 账 户 是 一 种 机 制 ， 用 于 控制 访问 其 中 创建 的 容器 


用 C# 创 建 存储 容器 | 存储 容器 存在 于 存储 账户 中 ， 包 含 blob、 文 件 或 互联 网 上 可 从 任何 地 方 访问 的 数据 
ASP.NET Razor 中 | 可 在 C#f 代 码 中 引用 存储 容器 。 使 用 存储 账户 名 、 容 嚣 名、 博客 名 、 文 件 或 需要 访问 的 数据 
引用 存储 容器 


第 E 


高 级 云 编程 和 部 署 


REAR: 

e 创建 ASPNET Web API 

e E Microsoft Azure 上 部 垩 和 使 用 ASP.NET Web API 
e {E Microsoft Azure EEN ASP.NET Web API 


本 章 源 代码 可 以 通过 本 书 合 作 站 点 wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter17 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 
Meer E. 

表面 已 经 化 了 一 些 时 间 学 习 云 和 云 编程 ， 下 面 再 进一步 ， 编 写 一 些 比 上 一 章 更 复杂 的 C# 人 代码。 本章 将 继续 


探索 ASPNET 和 Microsoft Azure, 修改 CardLib 程序 , 让 它 作 为 一 个 ASPNET Web API 运行 在 云 上 。 一 旦 部 署 ， 
就 可 在 ASPNET Web Site 上 使 用 它 。 


注意 : 
要 成 功 完成 本 章 的 练习 ， 需 要 有 Microsoft Azure 订阅 。 如 果 没 有 ， 可 在 http://azure.microsoft.com 上 注册 30 
天 期 限 的 免费 试用 版 。 这 十 分 便捷 。 


在 创建 、 部 署 和 使 用 ASPNET Web API 后 ， 将 学 习 如 何 缩放 它 。 缩 放 概念 很 重要 ， 掌 握 它 会 使 自己 创建 的 
云 程序 更 受 欢迎 。 本 章 中 的 示例 使 用 免费 的 Microsoft Azure 云 资源 。 这 些 免费 资源 有 较 低 的 CPU、 内 存 和 带宽 
阔 值 ， 在 高 使 用 率 下 很 容易 突破 。 本 章 将 学 习 如 何 适 时 地 缩放 云 程 序 ， 从 而 避免 由 于 突破 资源 阔 值 造成 云 程序 


暂停 。 


17.1 创建 ASP.NET Web API 


计算 机 编程 概念 “应 用 程序 编程 接口 (Application Programming Interface, API)” G2¢4F7EJL14F f , 38538 
述 为 一 个 模块 ， 包 含 一 组 可 用 于 构建 软件 程序 的 图 数 。 
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最 初 ， 从 Windows 客户 问 应 用 程序 的 角度 看 ， 这 些 模块 是 动态 链接 库 (. dDJ， 可 通过 “以 编程 方式 访问 ”的 
接口 同 其 他 程序 公开 内 部 阔 数 。 在 这 样 的 系统 中 ， 当 消费 程序 使 用 API 时 ， 将 会 依赖 接口 的 模式 。 修 改 接口 ， 
会 导致 消费 程序 异 利和 失败 ， 因 为 访问 和 执行 模块 内 图 数 的 当前 过 程 不 再 有 效 。 一 旦 程序 依赖 一 个 接口 ， 它 融 
不 应 该 改变 ， 当 它 改变 时 ， 该 事件 就 通常 称 为 DLL Hell. AX DLL Hell 的 更 多 信息 ， 可 以 阅读 http://www. 
desaware.com/tech/dllhell.aspx 上 的 文章 。 

随 痢 时 间 的 推移 ， 互 联网 和 内 联网 解决 方案 的 实现 成 为 主流 ， 也 实现 了 一 些 依赖 技术 ， 如 Web 服务 和 
Windows Communication Foundation(WCF). Web 服务 和 WCF 呈现 了 正式 协定 的 接口 ， 同 其 他 程序 公开 包含 在 
其 中 的 函数 。 在 前 面 提 到 的 DLL API 中 ,模块 和 使 用 它 的 程序 在 同一 台 计 算 机 上 ， 而 Web 服务 和 WC 在 一 台 
Web 服务 器 上 托管 。 由 于 托管 在 一 台 互 联网 或 局 域 网 Web 服务 器 上 ， 因 此 访问 Web 接口 不 再 局 限于 一 台 计 算 
机 ， 而 可 以 是 任何 设备 ， 从 任何 有 互联 网 或 内 联网 连接 的 地 方 访问 。 

回顾 前 一 草 分 析 的 云 优 化 堆栈 。 在 讨论 中 提 到 ， 为 进行 云 优 化 ， 程 序 必须 占用 空间 小 ， 能 处 理 高 吞吐 量 ， 
支持 跨 平 台 。ASPNET Web API 基于 ASP.NET MVC( 模 型 -视图 -控制 器 ) 的 概念 ， 这 与 新 的 云 优化 堆栈 的 定义 一 
致 。 如 果 己 经 创建 了 Web 服务 或 WCF， 或 者 过 去 使 用 过 ， 束 将 看 到 ，ASPNET Web API AMT Bi. X 
竣 。 如 果 从 未 使 用 它们 ， 也 能 体会 到 这 一 点 。 

下 例 将 创建 一 个 ASPNET Web API， 处 理 一 手 牌 。 


试 一 试 eE ASP.NET Web API 


下 面 使 用 Visual Studio 2017 创建 一 个 ASPNET Web API， 它 接收 一 个 玩家 的 名 字 ， 给 该 玩家 返回 一 手 牌 。 

(1) f£ Visual Studio 中 选择 File | New | Project..., 创建 一 个 新 的 ASPNET Web API. Œ New Project 对 话 框 ( 见 
图 17-1) 中 ， 选 择 类 别 Visual C£ | Web， 然 后 选择 ASPNET Web Application 模板 。 更 改 路 径 为 CABeginningCSharp7 
Chapter17， 把 Web 应 用 程序 命名 为 Ch17Ex01， 然 后 单 击 OK 按钮 。 


b Recent .NET Framework 4.7 * Sort by: Default * d 围 Search Installed Templates (Ctrl+E) P- 
4 Installed . 
$1 ASP.NET Web Application (.NET Framework) Visual C# Type: Visual C* 
4 Templates Project templates for creating ASP.NET 
4 Visual C & ASP.NET Core Web Application (NET Core) Visual C# applications. You can create ASP.NET Web 
Forms, MVC, or Web API applications and 


Windows Universal add many other features in ASP.NET. 


Windows Classic Desktop & ASP.NET Core Web Application (.NET Framework) Visual C# 
Web 

.NET Core 

.NET Standard 

Cloud 


b Online 


Name: Ch17Ex01 


Location: CABeginningCSharp Chapter 7 - 


Solution: Add to solution 


Solution name; Ch17Ex01 lv] Create directory for solution 


C] Add to Source Control 


图 17-1 


(2) 接 下 来 单 击 Empty ASPNET 4.7 Template, 3&rp Web API 复 选 框 , 将 需要 的 文件 夹 和 核心 引用 添加 到 项 
目 中 ， 见 图 17-2。 单 击 OK 按钮 。 
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An empty project template for creating ASP.NET 
ASP.NET 4.7 Templates applications. This template does not have any content in 
4 it. 
= ie. Learn more 
Web API Single Page 
Application 


T 


Azure AP] App 


Change Authentication 


Authentication: Mo Authentication 


Add folders and core references for: 


[|] Web Forms [| MVC iw] Web API 


[C] Add unit tests 


Test project name: — Ch17Ex01 Tests 


= 


A] 17-2 


(3) 右 击 Ch17Ex01 解决 方案 ， 然 后 选择 Add | New Folder， 将 文件 夹 重 命名 为 CardLib. 

(4) 从 下 载 站 点 下 载 示 例 代 码 ， 将 下 面 的 美文 件 放 在 刚才 创建 的 文件 夹 CardLib 中 。 下 载 完毕 后 ， 石 击 
CardLib 文件 夹 ， 并 选择 Add | Existing Item...， 再 从 下 载 的 示例 中 选择 以 下 7 个 类 。 

a. Card.cs 

b. Cards.cs 

c. Deck.cs 

d. Game.cs 

e. Player.cs 

f. Rank.cs 

g. Suit.cs 


注意 : 
ix 7 个 类 与 Ch16Ex02 中 使 用 的 7 个 类 一 样 。 如 果 前 面 的 练习 中 已 经 下 载 了 源 代 码 ， 也 可 以 在 这 里 重用 
它们 。 


(5) 下 面 添 加 一 个 控制 器 : 右 击 Controllers 文件 来 ， 选 择 Add | Controller...， 再 选择 Web API 2 Controller — 
Empty... | Add ( 见 图 17-3). 

(6) 把 控制 器 命名 为 HandOfCardsController. 

CT) 将 如 下 代码 添加 到 HandOfCardsController 类 中 : 


[Route ("api/HandofCards/ {playerName}") ] 
public IEnumerable<Card> GetHandOfCards (string playerName) 


Player[] players = new Player[l]l: 
players[0] = new Player (playerName); 
Game newGame = new Game(); 
newGame.SetPlayers (players); 
newGame.DealHands (); 

var handOfCards = players[0].PlayHand; 
return handofCards; 
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4 Installed 


b | | | 
Common fiv MVC 5 Controller - Empty Web API 2 Controller - Empty 
Controller by Microsoft 


+ MVC 5 Controller with read/write v2.0.0.0 
= An empty Web API controller. 


MVC 5 Controller with views, using 
&) ne, pared E Id: ApiControllerEmptyScaffolder 


e. Web API 2 Controller - Empty 


Web API 2 Controller with actions, 
using Entity Framework 


Mi Web AP! 2 Controller with read/write 
actions 


Web AP! 2 OData v3 Controller with 
actions, using Entity Framework 
Web AP! 2 OData v3 Controller with 
read/write actions 


Click here to go online and find more scaffoldin 
extensions. 
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(8) ASP.NET Web API 现在 已 创建 完毕 ， 准 备 发 布 到 云 中 。 
ASS! 前 面 创建 了 返回 一 手 牌 的 ASPNET Web API. 


示例 说 明 

创建 新 的 ASPNET Web API 时 ， 有 两 个 选项 。 这 个 示例 使 用 了 第 一 种 方法 。 从 模板 选择 窗口 中 选择 Empty 
模板 ， 表 示 这 个 项 目 只 包含 创建 ASPNET Web API 所 需 的 基本 内 容 ， 因 此 添加 到 解决 方案 中 的 配置 文件 和 二 
进 制 文件 很 少 。 这 个 Web API 占用 的 空间 非常 少 ， 这 正 是 在 云 中 优化 运行 所 需要 的 。 

另 一 种 可 能 的 方法 是 选择 Web API 模板 ( 见 图 17-2) 而 不 是 Empty 模板 。 这 包括 额外 的 配置 文件 、 许 多 额外 
的 引用 以 及 ASPNET MVC 应 用 程序 的 一 个 基本 例子 。 这 个 示例 相对 较 小 ， 不 需要 大 多 数 MVC 功能 ， 所 以 选 
$E f Empty 模板 。 如 果 在 未 来 目 己 的 项 目 中 需要 额外 的 功能 和 例子 ， 就 应 考虑 选择 Web API 模板 ， 因 为 它 构 建 
了 数据 管道 ， 提 供 了 许多 已 证 明 有 效 的 编码 模式 来 构建 解决 方案 。 

这 里 把 第 16 章 中 示例 使 用 的 7 个 类 添加 到 CardLib 目录 中 。GetHandOfCards0 方 法 的 内 容 与 第 16 章 中 的 相 
同 。 该 方法 接收 一 个 参数 playerName， 创 建 一 个 新 游戏 ， 设 置 玩 家 ， 发 牌 ， 并 给 ASP.NET Web API 消费 程序 
返回 Cards 类 。 添 加 的 一 行 代码 如 下 : 


[Route ("api/Handofcards/ {playerName}")] 


Route 注解 说 明 ASP.NET 如 何 决 定 哪个 Web API 方法 啊 应 哪个 请 求 。 发 布 后， 与 ASP.NET Web API 交互 
时 ， 并 没有 请 求 具体 文件 。 在 ASP.NET Web Forms 应 用 程序 中 ， 把 请 求 发 送 给 扩展 名 为 .aspx 的 文件 ， 但 在 调 
用 Web API( 或 ASP.NET MVC 应 用 程序 ) 时 ， 就 不 是 这 样 。 把 Web API 请 求 发 送 到 Web 服务 器 ， 其 参数 在 请 求 
的 URL "F, FERAL. Bilan: 

http: //contoso.com/api/ {controllerName} /Parameter1/Parameter?2 /etc... 

注意 : 

不 使 用 注解 (annotatiom) 来 创建 路 由 地 图 ， 而 可 在 App Start 目录 的 WebApiConfig.cs 中 创建 它们 。 


现在 创建 了 ASP.NET Web API， 下 一 节 学 习 ASP。ASP.NET Web API 的 部 署 和 使 用 。 
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17.2 # Microsoft Azure 上 部 署 和 使 用 ASP.NET Web API 


有 很 多 方法 可 用 于 将 Web 应 用 程序 部 署 到 Microsoft Azure 平台 上 。 最 流行 的 方法 之 一 是 使 用 本 地 Git 存储 
库 或 托管 在 GitHub 上 的 公共 Git 存储 库 。 本 地 和 公共 Git 存储 库 都 提供 了 版 本 控制 功能 ， 这 是 一 个 非 第 有 用 的 
功能 。 版 本 控制 允许 开 友 人 员 和 上 友 布 经 理 了 解 做 了 什么 改变 ， 并 了 解 执行 这 些 修改 的 时 间 和 操作 人 员 。 当 编 详 
二 进 制 文 件 ， 或 把 更 改 部 普 到 现场 的 环境 中 时 ， 如 果皮 生 问 题 或 未 预料 到 的 异 贡 ， 残 很 容易 找到 联系 人 。 可 以 
整合 到 Microsoft Azure 上 的 其 他 部 团 平 台 包 括 Visual Studio Team Services. OneDrive 和 Bitbucket。 


注意 : 
可 采用 许多 方法 把 代码 部 署 到 Microsoft Azure 平台 上 。 存 储 在 源 代码 存储 库 中 的 项 目 与 具体 的 独立 代码 场 
景 都 有 多 个 独立 部 署 选 项 。 


之 前 示例 中 的 代码 古 一 个 独立 项 目 , 不 包含 在 版 本 控制 库 中 , 在 IDE 中 直接 执行 部 普 。 本 例 是 在 Visual Studio 
2017 中 部 着。 部 普 不 包含 在 源 代 码 和 存储 库 中 的 解决 方案 的 其 他 方法 包括 Web 38-8 (msdeploy.exe)#! FTP. 
完成 以 下 示例 ， 把 ASPNET Web API 部 着 到 Microsoft Azure Web App 上 。 


试 一 试 #2 ASP.NET Web API 部 署 到 云 上 


(1) 右 击 Ch17Ex01 项 目 ， 选 择 Publish...， 之 后 选中 Create New 单 选 按钮 并 单 击 Publish 按钮 。 

(2) 从 Change Type 下 拉 列 表 中 选择 Web App， 选 择 订 阅 以 创建 Web App, FAH GHJ Microsoft Azure iT 
阅 ( 如 有 必要 )， 选 择 或 新 建 一 个 Resource Group， 选 择 或 新 建 一 个 App Service Plan， 最 后 单 击 Create 按钮 ( 见 图 
17-4). 


Create App Service «) Microsoft 


Host your web and mobile applications, REST APIs, and more in Azure 
Web App Name Change Type w 
-—— handofcards 
Subscription 
Microsoft Azure 
Resource Group 


BeginningCSharp (westeurope) 


App Service Plan 
BeginningCSharp (F1, West Europe) 


Clicking the Create button will create the following Azure resources 


Explore additional Azure services 


App Service - handafcards 


If you have removed your spending limit or you are using Pay as You Go, there may be monetary impact if you provision additional resources. 


Learn More 


图 17-4 


e Web App Name: 必须 是 唯一 的 名 称 。 

e Subscription: 如 果 有 多 个 Microsoft Azure 订阅 ， 就 选择 希望 创建 这 个 Web App 的 订阅 。 

e Resource Group: Azure 资源 的 四 辑 分 组 。 可 通过 这 种 方法 将 特定 的 项 目 或 应 用 程序 的 所 有 资源 分 组 在 
一 起 ， 这 有 助 于 更 好 地 省 理 这 些 资源 。 
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e App Service Plan: 想 要 运行 Web App 的 虚拟 机 类 型 。 例 如 ， 在 FREE 模式 下 运行 时 ， 将 与 其 他 租 尸 共 
享 资源 ， 而 在 STANDARD 模式 下 运行 时 ， 应 用 程序 则 运行 在 自己 的 虚拟 机 上 。 
(3) 一 旦 创建 完毕 ， 就 可 以 单 击 Settings... | Validate Connection 按钮 来 验证 该 连接 ( 见 图 17-5)， 确 保 正 确 建 
并 了 配置 和 和 凭据。 


Qj Publish 


handofcards - Web Deploy 


Publish methad: | Web Deploy M | 


| handofcards.scm.azurewebsites.net:443 
| handofcards 
Shandofcards 


NI Save password 


Destination URL: | http://handofcards.azurewebsites.net 
Validate Connection | © 
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(4) 在 ASPNET Web API 成 功 发 布 后 ,浏览 器 将 打开 ,通知 Web 应 用 程序 已 成 功 创建 .也 可 以 在 Visual Studio 
的 Output 窗口 中 查看 详细 信息 ， 找 到 发 布 步骤 的 更 多 信息 。 

(5) 检查 ASPNET Web API 的 啊 应 。 例 如， 现在 可 通过 http://handofcards.azurewebsites.net/api/HandOfCards/ 
Benjamin 进行 全 局 访问 ， 其 中 handofcards 是 创建 Microsoft Azure Web App 时 提供 的 名 称 ，Benjamin 是 玩家 的 
名 字 。 


注意 : 
默认 情况 下 ,不 同 浏 览 器 以 不 同方 式 显示 结果 ,例如 ,Internet Explorer 提示 下 载 一 个 JSON 文件 ,而 Chrome. 
Firefox 和 Edge 浏览 器 显示 一 些 XML 数据 。 重 要 的 是 我 们 得 到 了 响应 。API 的 用 法 参见 下 一 节 。 


示例 说 明 

在 Visual Studio 中 发 布 Web App 时 ， 它 在 后 台 使 用 Web Deploy 执行 实际 部 署 。 知 道 了 这 一 点 ， 如 果 有 特 
殊 的 部 署 要 求 ， 它 们 可 在 Properties\PublishProfiles 目录 下 的 发 布 配置 文件 中 设置 。*.pubxml 的 内 容 包含 给 定 部 
署 的 配置 项 和 依赖 关系 。 

部 署 完 成 后 ， 浏 览 器 会 显示 Web App 的 主页 ( 见 图 17-6)， 而 不 是 ASP.NET Web API. 


Your App Service app has been created 


Go to your app's Quick Start guide in the Azure portal to get 
started or read our deployment documentation. 
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与 包含 在 .dl]、Web 服务 或 WCF 服务 中 的 传统 API 不 同 ， 直 接 访 问 ASPNET Web API 实际 上 并 不 背 见 。 相 
反 ， 在 所 有 情况 下 ， 对 API 的 调用 来 自 包 含 在 另 一 个 (使 用 API 的 ) 项 目 或 解决 方案 的 代码 中 。 


现在 部 署 了 ASPNET Web API， 此 后 ， 就 可 以 在 能 发 出 HTTP 请 求 、 能 解析 ISON 文件 的 任意 客户 端 上 使 
用 它 。 以 下 示例 提供 的 指令 可 用 于 学 习 如 何在 ASPNET Web 页 面 上 使 用 刚才 发 布 的 ASPNET Web API。 


注意 : 
以 下 示例 修改 了 Ch16Ex02 ASP.NET 网 站 。 主 要 区 别 是 : 它 未 从 网 站 本 身 包 含 的 类 中 检索 Cards, m 
章 创 建 和 部 置 的 ASPNET Web API 中 检索 。 


试 一 试 ” 在 网 站 中 使 用 Web API 


下 面 使 用 Visual Studio 2017 修改 CH16Ex02 例子 ， 以 使 用 ASPNET Web API. 1% Web API 接收 一 个 玩家 的 
名 字 ， 并 给 玩家 返回 一 于 牌 。 

(1) 打开 Visual Studio 2017， 选 择 File | New | Web Site， 并 从 已 安装 模板 的 Visual C# 列 表 中 选择 ASPNET 
Empty Web Site. 

(2) Web Location KO C:\BeginningCSharp7\Chapter17\Ch17Ex02, RJE itt OK 按钮 继续 。 


注意 : 
ASP.NET Web API 的 输出 是 一 个 JSON 文件 , 它 的 格式 遵循 一 种 使 其 容易 解析 的 标准 格式 。 解 析 JSON X 
件 的 最 常见 方式 是 使 用 Newtonsoft Json È. 


(3) 为 安装 用 于 解析 ISON 文件 的 NewtonsoftJson Æ, Ait Ch17Ex02 项 目 ， 然 后 选择 Manage NuGet 
， 打 开 Visual Studio 中 的 一 个 选项 卡 ， 如 图 17-7 所 示 。 


Set ChlT ED 


Packages... 


M 


= Solution Explorer 


= r at k 
Browse Installed Updates ll NuGet Package Manager. Ch17Ex02 ta = e-S 6 @ Di "d =- 
Search Solution Explorer [Ctri--ü 
Search (Ctrl E 2- È C Include prerelease Package source: nugeLong |: fal Solution ‘Beginning? Sharp? (46 projects 
B Chapterü2 
E Chapterüa 
@ ChapierD4 
ES Chapierüs 
8 ChapierD6 
E ChapterD7 
E ChapterOB 
E Chapterün 
@ Chapter) 
E Chapieri! 
E Chaptertz 
B Chapter13 
B Chapter16 
Version 10.03 = Chapiri? 
@ jQuery by jQuery Foundation, Inc, 37.2, downloads vidt MN [UT e 4 = arn 
j is a new kind of JavaScript Library. : 
E is a fast and ine Library that simplifies HTML document... License T ei LO. COM Tames Mewtonsolt lsony master) b ES) BeginningCSharp? 


F NewtonsoftJson 


Versio | Latest stable 10.0.3 |- Install | 
@ NUnit by Charlie Poole, 11.2M downloads 


NUnit is a unit-testing framework for all MET languages with a strong TDD focus. (9) ‘Options 


Newtonsofttson oy lames Newton-King, 77.9 downloads 


Jacn. NET 15 a popular high-pertormance JSON Tramework tor .MET 


ver EntityFramework by Microsoft, 32M downloads on 
Entity Framework is MicrasofTs recommended data access technology tor new Jsor NET is a popular high-performance JSON framework l'or NET 
applications. 


| F T ER MEL NL IL NL ML ML EL ML ML NL ij 


LE ENSE 
B| bootstrap by Twitter, Inc, 113M downloads Date published: Sunday, June 18, 2017 (6/18/2017) 
Bootstrap framework in C55. Includes fonts and JavaScript Project URL: htt www.newtnneottcom/jron 


rtAbuse hitga Ne rnmigetang/nackages/Newtonsotz kon; 
: : g 
Repo rbAbuse 


ES AutoMapper by Jimmy Bogard, 9.87M downloads 
A convention-based object-object mapper. AutoMapper uses a fluent m 
configuration API te define an object-object mapping strategy. AutoMapper uses. 


Salutian Explorer Team Explorer Class View 
pun 


Depencencies 

Q ee iidem nam = NETFramework, Version=v2.0 

Deprecated NUnit 3 console minner - use NUnit onsale ar NUnit-CorsoleRunner. Mo desendencies 

-HETRamework, Versian- và 5 

JNETFramework.Versian- v3.8 
F No dependencies 
Each package is licensed to you by ris owner. Nuet ix not responsible Far, nar does it grant any licenses T QUT E 
to, third-party packages. i 
.NETPortabla, Version- v0.0. Profile - Profle328 
Me dependencies 


国 Microsoft AspMet. Mwe by Microsoft, 29.9M downloads W523 
This package CONTAINS ihe nurntime assemblies far ASP.NET MVE 


| Da nat show this again 


ErorList Quiput Find Symbol Results Breakpoints Call Hierarchy Web Publish Actmeity 
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(4) 从 Package 列表 中 选择 Newtonsoft.Json， 并 单 击 Install 按钮 。 将 Bin 目录 添加 到 ASP.NET Web Site 中 ， 
以 包含 Newtonsoft.Json.dll 库 。 

(5) 为 将 .cshtml 文件 添加 到 解决 方案 中 , 右 击 Ch17Ex02， 并 选择 Add | Add New Item... | Empty Page (Razor 
v3)， 命 名 为 default.cshtml， 单 击 Add 按钮 。 
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注意 : 
这 里 ，default.cshtml 文件 的 内 容 与 之 前 在 CHI6Ex02 中 创建 的 内 容 非 常 相似 ， 但 需要 做 一 些 调整 。 考 虑 复 
制 第 16 章 中 default.cshtml 的 内 容 ， 而 不 是 重新 输入 整个 页 面 。 


(6) 接 下 来 ， 在 页 面 的 项 站 添加 如 下 语句 ， 把 Newtonsoft.Json FAS F| Razor 文件 中 : 


@using Newtonsoft.Json; 


(7) 在 第 (6) 步 添加 的 代码 后 面 添 加 如 下 代码 段 : 


@{ 
List<string> cards = new List<string>(); 
var playerName = Request ["PlayerName™"]; 


if (IsPost) 
{ 
string GetURL = "http://handofcards.azurewebsites.net/api/" + 
"HandOfCards/" + playerName; 
WebClient client = new WebClient(); 
Stream datastream = client.OpenRead (GetURL); 
StreamReader reader = new StreamReader (dataStream); 
var results - 
JsonConvert.DeserializeObject«dynamic-» 
(reader.ReadLine()); 
reader.Close();: 


foreach (var item in results) 
{ 
cards .Add ( (string) item. imageLink); 
} 
| ] 
} 


(8) 最 后 ， 在 第 (7) 步 添加 的 代码 后 面 添加 如 下 标记 和 Razor 代码 ， 以 直接 使 用 ASPNET Web API: 


<html> 
<head> 
<title>BensCards: Deal yourself a hand. </title> 
</head> 
<body> 
@if (IsPost) 
{ 
«label id="labelGoal">Here is your hand of cards.</label> 
«br /> 
<div> 
<p><label id-"labelPlayerl"»Playerl: 
@playerName</label></p> 
@foreach (string card in cards) 
{ 
<img width="75" 
height="100" 
alt-"cardImage" 
Src-"https://deckofcards.blob.core.windows.net/carddeck/8card" /> 
} 
</div> 
«label id-"errorMessageLabel" /> 
} 


else 


«label id="lLabelGoal"> 
Enter the players name and deal the cards. 
</label> 
<br /><br /> 
<form method-"post"» 
<div> 
«p»Player 1: @Html.TextBox ("PlayerName") </p> 
<p><input type="submit" value="Deal Hand" class="submit"></p> 
</div> 
</form> 
} 
</body> 
</html> 


(9) TZ F5 功能 键 运行 ASPNET Web Site。 界 面 呈 现 出 来 后 , 输入 名 称 , 单 击 Deal Hand 按钮 。 ASPNET Web 
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Site 就 会 使 用 ASPNET Web API， 显 示 一 手 牌 ， 如 图 17-8 所 示 。 


À BensCards: Deal you. x V 71 


e € | D localhost:49905/default.cshtml 


== Apps [ handofcards.az... 


Here is your hand of cards. 


Playeri: Benjamin 


17-8 


示例 说 明 

最 初 显 示 default.cshtml 页 面 时 ，IsPost 属性 为 false, 因此 不 执行 在 Razor 代码 块 的 C# 代 码 中 对 ASPNET 
Web API 的 调用 ， 而 只 显示 else 代码 块 中 的 部 分 HTML 代码 。 呈 现 部 分 包含 一 个 捕获 玩家 名 字 的 文本 框 ， 以 及 
一 个 触发 把 页 面 回 送 给 目 己 的 按钮 。 

一 旦 输入 玩家 的 名 字 ， 单 击 Deal Hand 按钮 ，IsPost 属性 就 变 成 了 了 true， 执 行 页 面 了 项 部 Razor 标签 中 的 C# 
代码 。 


string GetURL = "http://handofcards.azurewebsites.net/api/HandOfCards/" + 
playerName; 

WebClient client = new WebClient(); 

Stream dataStream = client.OpenRead (GetURL); 


GetURL 字符 串 中 存储 的 Web 地 址 是 ASPNET Web API 的 互联 网 或 内 联网 位 置 ， 用 作 WebClient 类 中 
OpenRead0 方 法 的 一 个 参数 。WebClient 包含 执行 HTTP 请 求 所 需 的 方法 。OpenRead0 方 法 的 结果 存储 在 一 个 
Stream X] AA. 


StreamReader reader = new StreamReader (dataStream); 
var results = JsonConvert.DeserializeObject«dynamic-» 
(reader.ReadLine()); 


然后 Stream 对 象 作 为 一 个 参数 传递 给 StreamReader 构造 函数 ,使 用 StreamReader 类 的 ReadLine0 方 法 作为 
参数 ， 使 用 NewtonsoftJson 库 来 反 序 列 化 JSON MF, Si up foreach 语句 来 枚 举 ， 并 添加 到 List<string> 
ar cards 中 。cards 列表 可 以 访问 ， 用 于 后 和 面 的 页 面 呈现 过 程 。 


foreach (var item in results) 


{ 
cards .Add( (string) item. imageLink) ; 


} 


注意 : 
回顾 一 下 前 面 第 13 章 讨 论 的 dynamic 类 型 。dynamic 类 型 与 JSON 文件 一 起 使 用 是 很 常见 的 ， 因 为 它 包 含 
的 结构 并 不 总 是 可 以 强制 转换 为 强 类 型 的 类 。 
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一 旦 JSON 文件 的 解析 结果 被 加 载 到 cards 容器 中 ， 就 执行 IsPost 代码 块 内 的 标记 代码 。Razor 标签 内 的 
foreach 循环 读 取 cards 容器 ， 连 接 图 片 名 称 和 第 16 章 创建 的 Microsoft Azure Blob Container 链接 。 
@foreach (string card in cards) 
icis width-"75" 
height-"100" 


alt-"cardImage" 
src-"https://deckofcards.blob.core.windows.net/carddeck/8card" /> 


可 以 考虑 使 用 从 之 前 示例 中 获得 的 知识 把 这 个 ASPNET Web Site 部 署 到 Microsoft Azure 平台 上 。 例 如 ， 只 
需要 右 击 Ch17Ex02 解决 方案 ,选择 Publish Web App， 并 按照 友 布 问 导 的 指示 进行 操作 。 创 建 一 个 Web 应 用 程 
Ff handofcards-consumer， 将 可 从 http://handofcards-consumer.azurewebsites.net/ 访 问 它 。ASPNET Web API 和 
Microsoft Azure Blob Container 都 可 在 世界 上 的 任何 地 方 通过 互联 网 访问 ， 把 ASPNET Web Site 放 在 Azure E, 
会 得 到 相同 的 结果 (获得 一 手 牌 )。 

随 痢 时 间 的 推移 ， 如 果 使 用 程序 或 API 较 受 欢迎 ， 开 始 收 到 很 多 请 求 ， 在 FREE 模式 下 运行 的 Web App 3L 
可 能 导致 资源 国 值 被 突破 ， 使 资源 不 可 用 。 这 并 不 是 最 理想 的 。 下 一 节 将 了 解 如 何 扩展 在 Microsoft Azure 平台 
上 运行 为 Web App 的 ASPNET Web API， 以 便 用 户 和 客户 可 以 在 需要 时 访问 可 啊 应 的 Web 资源 。 


17.3 缩放 Microsoft Azure 平台 上 的 ASP.NET Web API 


以 前 ， 缩 放 以 满 吓 用 尸 的 需求 是 一 项 非 第 肾 杂 、 费 时 、 兄 贯 的 活动 。 历 史上 ， 当 公司 想 增 加 服务 占 容 量 以 
文 持 更 多 流量 时 ， 就 需要 采购 、 装 配 物 理 硬 件 ， 把 物理 硬件 配置 到 数据 中 心 。 然 后 ， 一 旦 硬件 进入 网 络 ， 就 交 
给 应 用 程序 所 有 者 ， 安 沪 并 配置 操作 系统 、 所 需 的 组 件 和 应 用 程序 的 源 代码 。 执 行 此 类 任务 所 需 的 时 间 很 长 ， 
而 公司 配备 了 大 量 的 物理 容量 ， 供 高 峰 时 间 使 用 ;然而 ， 在 非 高 峰 时 期 ， 额 外 的 容量 却 未 使 用 ， 只 能 用 置 ， 这 
是 一 种 非 第 郧 员 、 非 最 优 的 资源 分 配方 法 。 

更 好 的 方法 是 使 用 云 平 台 ， 在 需要 资源 时 ， 诸 如 Microsoft Azure 的 平台 提供 利用 物理 资源 向 上 、 向 下 、 癌 
外 扩展 的 最 优 能 力 。 当 需要 CPU、 磁 盘 空 间或 内 存 等 物理 资源 时 ， 就 同上 或 回 外 扩展 来 满足 要 求 ， 当 对 云 服 务 
的 需求 减少 时 ， 可 绾 减 物理 资源 ， 把 经 费用 于 其 他 项 目 和 服务 。 


注意 : 
为 成 功 完成 本 章 的 练习 ， 需 要 有 Microsoft Azure 订阅 。 如 果 没 有 ， 可 在 http://azure.microsoft.com 上 注册 30 
天 期 限 的 免费 试用 版 ， 这 十 分 便捷 。 


本 章 的 其 余部 分 说 明了 如 何 根据 CPU 的 需求 在 具体 的 时 间 段 里 绑 放 ASP.NET Web API. 
试 一 试 ”根据 CPU 的 需求 缩放 ASP.NET Web API 


(1) 访问 Microsoft Azure 门户 网 站 https://portal.azure.com. 
(2) 选择 本 章 前 面 创建 的 ASPNET Web API, 例如 handofcards。 如 图 17-9 所 示 ， 注意 Web App 在 FREE 定 
价 层 。 仅 当 Web App 处 于 STANDARD 模式 时 ，Anuto Scaling 才 可 用 。 
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O Search (Ctri«/) [^ Browse W Stop Ea Swe $) Restart D Delete y Get publish profile Q Reset publish profile 


Resource group (change) URI 

BeginningCSharp uni ieri ards.azurewebsites.net 

Status ti 

Running 
Sh Weblobs Location FTF deployment username 

West Europe handofeards\ben 
EB push Subscription (change) FTP hostname 

Microsoft Azure ftp;//waws-prod-am2- ^ ftp.azurewebsites.windows.net 
E MySQL In App Subscription ID FTPS hostname 

e 5echbae- ftps//waws-prod-am2- .ftp.azurewebsites.windows.net 


图 17-9 


(3) 单 击 Scale up(App Service Plan) 链接 ， 选 择 S1、S2 8X S3, Pjüi UB AT Select 按钮 ， 将 Web App 
i EP REFI] STANDARD. 

(4) 一 旦 完成 辐 上 扩展 ， 就 单 击 Scale out (App Service plan), Hj Eit; Enable autoscale 与 Add a rule 按钮 ( 见 
17-10)。 从 Metric name 下 拉 列 表 中 选择 CPU Percentage. 


Esse ose — CQ Disable autoscale C} Refresh 
Contigure unhstor JEON Moby 
H> Networking 一 一 一 
Dad r Ir frs. i 
NE Sakia Dp Senece peri * Autoscale setting name | ScaleWhenCPuist0Percent 
a e e Rx - 
ifi Scale Out (App Service plani) BeginningCSharp 


d WebJobs 
EB Push Default Auto created scale condition g7 


B. MysQLIn App i _ 
Scale moda © Scale based on a metric 人 Seale lo a specific instance count 
|! Properties 
(p Scale out and scale in your instances based on metric. For example, add a rule that increases instance court by 1 when CPU percentage 
TUE 


B Ls = 5 above 
SUHF 


Criteria 
E automation script + Add a nule * Time aggregation & 
Average d 
Mirumurr d 
1 * Meine naire 


TUER Instance limits 


p. App Service plan CPU Percentage - 
| Schedule This scale condition iz executed when none of the other scale condition(s) match 1 minute time grain 
ilu Quotas * Time grain statistic © 
; Awerage hi 
A Change App Service plan 
* (Operator 


Greater than 


* Threshald 


A ~] 


图 17-10 


(5) 将 Instance limits 的 Maximum 改 为 5， 将 Threshold 改 为 80. 
(6) "i Add 按钮 ， 再 单 击 Save 按钮 ， 保 存 该 规则 。 


示例 说 明 

ft FREE 模式 下 运行 Web App 并 没有 太 多 好 处 。 它 其 实 只 是 用 于 测试 和 学 习 Microsoft Azure 平台 是 如 何 工 
作 的 。 目 动 伸缩 功能 只 在 STANDARD 或 更 高 模式 下 可 用 , 因此 只 有 扩展 到 这 一 层 , 才能 访问 该 功能 。SHARED 
fll BASIC 等 其 他 模式 也 允许 扩展 ， 但 需要 手动 配置 。 

默认 情况 下 ， 对 于 给 定 的 10 分 钟 时 间 ， 每 1 分 钟 检查 一 次 。 如 果 CPU 利用 率 平均 在 70% 以 上 ， 自 动 伸 缩 
功能 最 多 可 同上 扩展 到 这 个 App Service Plan A 1 个 实例 。 图 17-10 中 ， 修 改 成 当 CPU HFEA 80% HT, 
最 多 可 同上 扩展 5 个 实例 。 这 意味 看 ， 当 1 个 实例 的 平均 CPU 利用 率 连 续 10 分 钟 超过 80% 时 ，Azure 平台 将 
添加 男 一 个 实例 。 如 果 这 两 个 实例 eh CPU 利用 率 超 过 80%， 就 会 再 添加 一 个 实例 。 这 种 行为 会 一 
直 持 续 到 最 多 5 个 实例 。 在 STANDARD App Service plan 中 ， 实 例 的 绝对 最 大 数量 为 10。 

考虑 S1 App Service Plan (ASP), 它 相 当 于 1 x 2.6 GHz 的 CPU 和 1.75GB AT. 这 意味 着 当 扩 展 到 最 多 
5 个 实例 时 , 会 有 5 台 不 同 的 虚拟 机 可 用 , 每 台 虚 拟 机 都 具有 1x2.6 GHz 的 CPU 和 1.75GB 的 内 存 , 它们 以 Web 
Farm 形式 运行 着 同一 个 Web App。 按 照 这 条 规则 ， 如 果 选 择 的 是 S3 ASP， 会 有 5 台 虚 拟 机 可 用 ， 每 台 虚 拟 机 
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有 4X2.6 GHz 的 CPU 和 7GB 的 内 存 。 
最 后 ， 当 运行 Web App 的 虚拟 机 上 的 CPU 利用 率 降 至 所 配置 的 CPU 国 值 百 分 比 以 下 时 ， 如 低 于 80%( 见 
图 17-10)， 就 从 Web Farm 中 删除 一 个 实例 或 虚拟 机 ， 直 到 Minimum 文本 框 中 设 定 的 最 小 实例 数量 。 


目 动 伸缩 功能 非常 适 于 管理 意 想 不 到 的 Web App 使 用 局 峰 期 和 对 Web App 的 请 求 。 不 过 ,如果 已 知客 已 或 
用 户 何 时 与 Web App 交互 ， 就 可 以 提前 规划 ， 在 实际 需要 时 ， 夭 提前 一 点 提供 额外 的 实例 。 好 处 是 不 需要 根据 
CPU 的 使 用 情况 逐步 增加 或 减少 实例 ， 而 可 以 立即 缩放 到 特定 的 时 间 段 需要 的 CPU 数量 和 内 存量 。 例 如 ， 如 
果 知 道 营销 部 门 会 在 10 月 安排 一 场 活动 ,就 可 以 在 那个 月 安排 售 外 的 可 用 资源 .使 所 需 的 资源 可 用 并 进行 预 热 ， 
就 可 以 避免 它们 延迟 分 配给 用 户 或 客户 使 用 。 执 行 下面 例 子 中 的 步骤 ， 看 看 具体 操作 。 


试 一 试 “在 特定 时 间 缩 放 ASP.NET Web API 


(1) 访问 Microsoft Azure 门户 网 站 https://portal.azure.com. 

(2) 选择 本 章 前 面 创 建 的 ASPNET Web API， 例 如 handofcards。 注 意 如 果 Web App 在 FREE 定价 层 ， 上 自动 
伸缩 功能 就 不 可 用 ; 只 有 当 Web App 处 于 STANDARD 模式 或 更 高 模式 时 ， 自 动 伸 缩 功 能 才 可 用 。 

(3) 单 击 Scale up(App Service plam)， 选 择 S1, S2 或 S3, "Eit mE ABIT] Select 按钮 ， 把 Web App 同上 扩 
展 到 STANDARD 模式 。 

(4) 一 旦 保存 了 配置 ， 就 选择 Scale out(App Service plan). Adda scale condition， 显 示 基 于 日 期 和 时 间 的 扩 - 
展 选项 ， 如 图 17-11 所 示 。 选 中 Specify start/end dates 单 选 按钮 。 


Auto created scale condition 47? qm 


Scale mode (8) Scale based on a metric O Scale to a specific instance count 


性 Scale out and scale in your instances based on metric. For example, add a rule that increases instance count by 1 when CPU percentage 


Rules is above 70%" 
=+ Add a rule 
Minimum @ Maximum @ Default @ 
Instance limits 
1 1 1 
Schedule (&) specify start/end dates Č Repeat specific days 
Timezone (UTC 01:00) Amsterdam, Berlin, Bern, Rome, Sto... v 
Start date 2017-07-21 00:00:00 
End date 2017-07-21 RE 22:59:00 


17-11 


(5) 输入 时 区 、 日 期 和 时 间 ， 如 图 17-12 所 示 。 


Schedule (e) Specify start/end dates © Repeat specific days 


Timezone (UTC) Coordinated Universal Time 
Start date 2017-10-01 
End date 2017-10-31 
图 17-12 
(6) 单 击 页 面 底部 的 SAVE 按钮 ， 当 配置 的 时 间 段 到 达 时 ， 缩 放 设置 就 会 生效 。 


为 缩放 Web App 创建 时 间 表 时 ， 需 要 名 称 、 开 始 日 期 、 开 始 时 间 、 结 束 日 期 和 结束 时 间 。 有 了 这 些 信息 ， 
Microsoft Azure 平台 就 可 以 管理 可 用 实例 的 数量 ， 这 些 实例 是 在 配置 好 的 时 间 段 内 为 Web App 的 请 求 提供 服务 
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的 虚拟 机 。 可 以 创建 无 数 时 间 表 ， 每 个 都 有 目 己 的 实例 数量 和 缩放 设置 。 只 要 创建 时 间 表 ， 保 存 它 ， 在 需要 时 
从 Schedule 下 拉 框 中 选择 它 ， 资 源 束 会 按 预 期 变 成 可 用 资源 。 


17.4 习题 


(1) 不 是 在 ASP.NET Web Site 应 用 程序 中 使 用 ASPNET Web API， 而 是 在 另 一 种 应 用 程序 类 型 中 使 用 它 ， 
例如 控制 台 应 用 程序 或 Windows 通用 应 用 程序 。 

(2) 对 于 Microsoft Azure 平台 上 的 Web App， 实 例 的 最 大 大 小 和 数量 是 多 少 ? 

附录 A 给 出 了 习题 答案 。 


17.5 FHRA 


t M 要 A 
ASP.NET Web API ASP.NET Web API 是 一 个 互联 网 或 内 联网 接口 ， 它 提供 了 供 外 部 程序 使 用 的 方法 
部 署 到 云 中 使 用 诸如 Visual Studio, WebDeploy, Git 或 FTP 等 工具 将 程序 部 署 到 云 中 
使 用 Web API ASP.NET Web API 将 方法 的 输出 返回 到 ISON 文件 中 。 使 用 Newtonsoft Json 类 库 解 析 和 使 用 其 内 容 
在 云 中 缩放 Microsoft Azure Web App 人 允许 根据 已 定义 的 时 间 表 或 CPU 使 用 率 自动 缩放 。 需 要 更 多 的 资源 时 可 以 扩 


大 ， 不 再 需要 资源 时 可 以 缩小 ， 这 是 云 最 具 价值 的 一 个 优点 


第 18. 


.NET Standard 与 .NET Core 


使 用 Visual Studio 构建 NET Core 应 用 程序 
从 .NET Framework 移植 到 NET Core 


KEAN: 

e 路 平台 原理 以 及 “必须 熟悉 的 ”关键 术语 
e NET Standard 的 含义 和 作用 

e SIH SA mite 

e NET Core 有 的 含义 

e 构建 与 打包 .NET Standard 库 

* 


KARRETE: 
本 章 源 代码 可 以 通过 本 书 合 作 站 点 wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapterl8 文件 夹 中 并 已 根据 本 章 示 例 的 名 称 单 


在 许多 年 间 ， 甚 至 可 能 是 在 几 十 年 的 时 间 内 ，Microsoft Windows 操作 系统 这 个 平台 的 使 用 率 和 市 场 占有 率 
非常 高 ， 所 以 对 跨 平 台 文 持 的 需求 非 第 有 限 。 公 司 和 开发 人 员 使 用 .NET Framework 创建 软件 ， 并 不 考虑 文 持 
Android. Apple 或 Linux， 所 创建 的 软件 只 运行 在 Microsoft Windows 平台 上 。 随 着 移动 设备 、IoT 设备 和 基于 
触摸 操作 的 设备 的 兴起 ， 这 些 平台 也 开始 受到 广泛 欢迎 ， 使 得 许多 公司 开始 重新 思考 自己 对 跨 平 台 的 支持 以 及 
面临 的 机 遇 。 

NET Framework 在 一 开始 设计 时 ， 目 标 丈 是 能 路 平台 运行 ， 能 在 不 同类 型 的 处 理 器 (如 x86. ARM 8k x64) 
上 运行 , 并 能 与 其 他 编程 语言 互 操作 。 设想 的 .NET Framework 跨 平台 运行 的 方式 是 , 首先 编译 为 一 种 中 间 语 言 ， 
弟 被 称 为 通用 中 间 语 言 (Common Intermediate Laneuage，CIL)， 之 前 被 称 为 Microsoft Intermediate Language 
(MSIL). CIL 被 认为 是 人 类 可 读 的 最 低级 代码 。CIL 然后 被 编译 为 本 机 代码 ， 即 处 理 右 直接 执行 的 机 右 码 (0 和 
1)。 编 译 成 本 机 代码 后 ( 稍 后 讨论 这 个 过 程 )， 指 令 就 能 在 目标 平台 和 处 理 器 上 运行 。 最 后 ,根据 处 理 器 的 类 型 和 
版 本 ， 可 对 CIL 编译 成 本 机 代码 的 过 程 进 行 优化 。 例 如 ，Intel Core 15 处 理 器 的 一 些 功能 和 指令 集 在 Pentium 4 
处 理 器 上 是 找 不 到 的 。 
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注意 : 
本 章 不 讨论 如 何 根据 处 理 器 类 型 来 配置 编译 器 选项 ， 进 而 优化 执行 。 你 可 在 互联 网 上 搜索 “NET Compiler 
Optimizations” ， 了 解 关于 这 个 高 级 主题 的 更 多 信息 。 


可 采取 两 种 方法 将 CIL 代码 编 诺 为 本 机 代码 : 实时 (Just in Time，JIT) 或 预先 (Ahead of Time，AOT) 编 详 。 
从 “实时 ”这 个 名 称 可 以 猜 到 ， 这 种 编译 是 在 执行 程序 集 的 内 容 时 发 生 的 。 这 意味 大 将 C# 代 码 部 署 到 一 个 平台 
上 上 时， 代码 会 你 持 CL 形式 ， 直 到 请 求 调用 方法 时 才 编 译 。 程 序 集 (或 .d 册 在 用 到 的 时 候 会 一 次 编译 一 点 儿 。 这 
与 AOT 不 同 . 在 AOT 编译 中 , 所 有 程序 集 在 被 部 普 之 前 , 先 在 目标 平台 和 处 理 器 类 型 上 编译 为 本 机 代码 。 AOT 
编译 中 使 用 的 工具 是 NGEN. 

NET Framework 器 平台 文 持 的 前 提 是 有 一 个 公共 语言 运行 库 (Common Language Runtime, CLR), "up 
CIL 转换 为 在 目标 平台 上 运行 的 本 机 代码 。CLR 党 被 称 为 “虚拟 机 ”( 但 不 要 与 使 用 Hyper-V 或 VMWare 创建 
的 VM 混 消 )。 如 果 没 有 用 于 Android. Apple OS £& Linux 的 CLR 虚拟 机 , CIL 就 无 法 编译 并 运行 在 这 些 平台 上 。 
但 .NET Framework 并 没有 完整 地 创建 或 文 持 这 些 虚 拟 机 ， 这 是 Mono 和 Xamarin 兴起 的 主要 原因 ， 最 终 也 导 
致 NET Standard 和 .NET Core 框架 的 出 现 。 

最 后 ， 从 互 操 作 的 角度 看 ，.NET Framework 库 可 被 多 种 语言 使 用 ， 如 F#、PowerShell、Eiffel、COBOL 和 
Visual Basic NET。“ 互 操作 ”这 个 概念 指 的 是 ， 如 果 一 个 模块 (如 DLL 文件 ) 是 用 FAS, MAHERE 
CLI 语言 (如 C 雪 编写 的 程序 都 可 使 用 该 模块 内 的 对 象 和 方法 。 要 使 用 这 些 对 象 和 方法 ， 需 要 把 该 F# 模 块 作为 引 
用 添加 到 C# 项 目 中 ， 然 后 在 .cs 文件 的 顶部 用 using 指令 声明 该 模块 。 

现在 , 你 知道 了 .NET Framework 最 初 被 设计 为 跨 平 台 运 行 , 以 及 最 初 设 想 的 实现 这 种 跨 平 台 运 行 的 方式 (使 
用 CIL 和 CLR 虚拟 机 )。 本 章 的 剩余 部 分 将 讨论 从 NET Framework 转向 .NET Core 的 原因 ， 并 列举 一 些 示例 来 
说 明 如 何 创 建 .NET Standard 库 和 .NET Core 项 目 。 下 一 节 先 介绍 一 些 必须 知道 的 跨 平 台 和 开源 方面 的 术语 。 


18.1 ”器 平 台 基 础 知识 以 及 必 知 的 关键 术语 


跨 平台 程序 就 是 可 运行 在 多 个 操作 系统 上 的 程序 ， 这 里 的 操作 系统 可 以 是 Microsoft Windows、Android、 
macOS 和 Linux 等 。 创 建 跨 平台 程序 的 目标 是 ， 只 编写 程序 一 次 ， 然 后 在 支持 的 操作 系统 上 编译 ， 部 署 该 程序 
后 , 代码 在 每 个 目标 操作 系统 上 以 相同 的 方式 执行 , 并 表现 出 一 致 的 行为 。 在 过 去 , 即使 使 用 了 开源 库 ( 如 Mono 
或 Java) 也 很 难 实现 这 个 目标 , 而 且 如 前 所 述 ， 如 果 使 用 完整 的 NET Framework， 并 不 能 真正 地 创建 跨 平台 的 程 
FF. 面临 的 许多 复杂 问题 源 于 跨 平 台 代码 在 使 用 操作 系统 服务 (如 磁盘 IO、 安全 协议 和 网 络 访问 )j 时 ， 对 不 同 操 
作 系 统 的 服务 之 间 存 在 的 细微 差别 进行 处 理 的 方式 。 

随 着 程序 员 开 始 将 更 多 注意 力 放 在 编写 能 够 轻松 跨 平台 运行 的 C# 代 码 上 ， 考 虑 这 些 为 数 众多 的 “ 必 知 ” 概 
念 和 术语 ， 有 助 于 打下 坚实 基础 。 表 18-1 列举 并 描述 了 这 些 关键 术语 。 


表 18-1 关键 的 跨 平台 术语 


关键 术语 já $ 
硬件 平台 x86、64 位 、Itanium、ARM 等 
软件 平台 HERS: Windows, Linux, Android, macOS, iOS 等 
PPP 编写 代码 一 次 ， 当 针对 目标 平台 编译 代码 后 ， 束 能 在 任何 支持 的 硬件 和 软件 平台 上 运行 代码 
生态 系统 社区 资源 、 开 发 工具 和 运行 时 软件 的 总 称 
堆栈 (stack) 在 一 起 使 用 的 硬件 、 软 件 和 生态 系统 ， 用 来 构建 和 运行 程序 ， 如 Windows 堆栈 、Linux 堆栈 等 
API 应 用 程序 编程 接口 (Application Programming Interface, API)AF TÆ., Bit. HOCK. BOMBA, EHe 
程序 使 用 
程序 集 一 个 .dl 文件， 公开 了 API， 供 其 他 程序 集 或 可 执行 文件 使 用 


标准 API 的 正式 规范 或 协定 


关键 术语 
垂直 模型 (Verticals) 
框架 / 库 
开源 
GitHub 
^] X (forking) 


依赖 
元 数据 
包 
元 包 
NuGet 
BCL 


PCT, 
运行 库 
CoreCLR 
CoreFX 
CoreRT 


.NET Native 
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( 续 表 ) 
Windows Forms, ASP.NET, WPF, UWP 等 ， 常 称 为 应 用 程序 模型 
API 的 丰富 集合 ， 用 于 创建 专注 于 特定 垂直 模型 的 程序 ， 以 程序 集 的 形式 出 现 
由 软件 开发 人 员 的 开放 社区 编写 和 支持 的 框 染 和 代码 库 。 可 根据 特定 开源 库 的 许可 使 用 对 应 的 库 
一 个 在 线 的 开源 代码 存储 库 ， 用 于 分 享 和 更 新 公共 可 用 的 和 社区 支持 的 代码 ， 以 及 创建 这 种 代码 的 分 支 
也 称 为 branch， 但 上 暗含 看 开发 社区 的 一 种 分 歧 。 分 文 就 是 用 现 有 的 源 代码 存储 库 的 副本 ， 进 行 新 的 独立 
开发 。 例 如 ，.NET Core 就 是 .NET Framework 的 一 个 分 文 
框架 的 每 个 版 本 包含 新 的 或 改进 的 API， 还 可 能 包含 对 bug 的 修复 
此 概念 采用 以 下 格式 来 描述 修改 的 规模 和 类 型 : [MAJOR].[MINOR].[PATCH]。 如 果 MAJOR 数字 发 生变 
化 ， 则 该 版 本 的 影响 比 MINOR 发 生变 化 时 更 大 
程序 依赖 的 API 集合 ， 如 dotnet-sdk-2.0.4-win10-x64 
目标 框架 名 对 象 (Target Framework Moniker, TFM) Æ H br f£ AE BIB fi hz 4s, HDD netstandard2.0 或 
netcoreapp2.0. TFM 常用 于 让 程序 面向 特定 的 框架 版 本 
编译 程序 或 完成 某 个 任务 必须 用 到 的 一 组 特定 程序 集 
提供 了 关于 其 他 数据 的 信息 的 数据 ， 如 创建 日 期 、 创 建 者 和 文件 大 小 
一 组 程序 集 和 元 数据 
一 组 相互 依赖 的 包 ， 但 没有 目 己 的 库 或 程序 集 
一 个 用 于 .NET 的 包 管 理 器 ， 可 帮助 开发 人 员 创 建 和 使 用 包 
基 类 库 (Base Class Library，BCL) 是 第 用 类 、 接 口 和 值 类 型 的 一 个 集合 。 例 如 ，System.* 指 令 中 的 类 、 接 
口 、 方 法 和 值 类 型 
可 移植 类 库 (Portable Class Library，PCL) 是 一 个 类 库 ， 不 必 重 新 编译 就 可 以 运行 在 多 个 .NET 垂直 模型 中 
公共 语言 运行 库 (Common Language Runtime, CLR). CLR 管理 内 存 分 配 (垃圾 回收 )、 编 译 和 执行 
与 CLR 相同 ， 但 可 跨 平 台 运 行 。 这 是 .NET Core 的 公共 语言 运行 库 引 擎 
NET Core System.* 名 称 空间 ， 严 重 依赖 于 运行 库 
类 似 于 CoreCLR 运行 库 ， 但 没有 JIT 编译 器 。 程 序 将 预先 编译 (参见 NET Native)， 在 这 个 过 程 中 ， 将 移 
除 所 有 多 余 的 代码 和 元 数据 
创建 的 本 机 代码 将 被 预先 编译 ， 第 用 于 UWP 开发 


理解 了 这 些 关 键 的 术语 后 ， 我 们 接 下 来 讨论 Microsoft 新 引入 的 跨 平 台 库 和 框架 : NET Standard 和 .NET 


Core. 


18.2 .NET Standard 的 含义 和 作用 


如 图 18-1 所 示 ， 开 发 人 员 和 公司 可 针对 多 个 垂直 模型 或 应 用 程序 模型 创建 程序 。 例 如 ，Windows Forms, 
ASPNET 和 WPF 基于 完整 的 NET Framework, Windows Phone 使 用 NET Compact Framework, Universal Windows 
Apps 则 基于 .NET Native 库 。 
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公共 语言 运行 库 CoreCLR .NET Native/CoreFX | Android/iOS/OS X 
Universal 
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(UWP) 


Windows ASPNET 
Phone re 


SilverLight 


SilverLight a | Compact _ t 
Í Micro PE = Core HE Mono = 


运行 库 


图 18-1 


图 18-1 中 显示 的 .NET Compact Framework. .NET Core. .NET Microframework 和 其 他 框架 都 包含 某 种 类 型 
的 基 类 库 (BCL) 功 能 ， 这 些 功 能 是 从 完整 的 NET Framework 分 支出 来 的 。 


注意 : 

分 支 说 明基 础 代码 具有 稳固 基础 ， 现 在 被 用 于 一 个 独立 的 、 特 别 定制 的 代码 版 本 。 

以 .NET Microframework 分 文 为 例 。 这 个 分 文 有 精简 后 的 BCL, 专门 用 在 小 型 物 联 网 (Intermnet of Things, IoT) 
设备 上 ， 对 于 这 种 设备 来 说 ， 完 整 的 NET Framework 占用 的 空间 太 大 ， 不 能 作为 在 这 种 硬件 平台 上 可 行 的 库 。 
对 于 小 型 设备 ， 完 整 的 NET Framework 使 用 的 存储 空间 和 内 存 空间 太 大 了 。.NET Microframework 的 大 小 和 内 
存 需 求 都 降低 了 ， 所 以 能 在 该 平台 上 有 效 工作 。 为 减 小 NET Microframework， 移 除了 完整 的 NET Framework 
中 第 见 的 一 些 功能 。 精 简 和 /或 修改 的 功能 要 求 开 及 人 员 了 解 该 特定 框架 的 垂直 模型 BCL 库 的 细节 。 每 个 应 用 
程序 模型 的 需求 集 都 稍 有 区 别 ， 所 以 才 会 从 NET Framework 产生 许多 分 文 。 

当 开 发 人 员 想 要 让 程序 运行 在 Windows PC 以 及 Windows Phone 上 ,并 作为 Universal Windows App 运行 时 ， 
以 前 必须 为 这 些 垂直 模型 创建 多 个 项 目 和 源 代 码 。 从 前 面 的 内 容 可 以 知道 ， 大 部 分 时 候 ， 每 个 于 直 模 型 BCL 
库 的 功能 实现 都 明显 不 同 ， 在 安全 性 、 联 网 功能 、 远 程 处 理 、 反 射 和 文件 访问 等 方面 尤其 如 此 。 这 如 要 求 开 发 
人 员 学 习 、 开 上 友和 文 持 每 个 竺 直 横 型 的 BCL 库 限制 ， 带 来 的 后 果 就 是 公司 的 成 本 增加 。 成 本 增加 的 原因 在 于 需 
要 开 友 、 测 试 、 部 垩 和 支持 同一 个 程序 的 多 个 版 本 。 


注意 : 


大 部 分 难以 轻松 移植 到 不 同 重 直 模型 的 功能 专门 包含 在 mscorlib.dll 中 。 


从 图 18-1 中 还 可 以 看 到 , 每 个 应 用 程序 模型 使 用 的 每 个 NET Framework i217 (Compact. Micro, Silverlight. 
Core 等 ) 对 于 在 目标 牌 直 模 型 和 平台 上 成 功 运 行程 序 仍然 是 不 可 或 缺 的 。 当 开发 人 员 决 定 将 菏 个 牌 直 模 型 作为 
目标 时 ， 就 会 在 Visual Studio 中 创建 解决 方案 和 项 目的 时 候选 择 目 标 框架 。 因 此 ， 每 个 生 直 模型 将 在 日 己 的 运 
行 库 或 虚拟 机 内 执行 ， 并 且 必 须 针对 目标 应 用 程序 模型 进行 编译 ， 在 部 闭 时 带 有 依赖 的 组 件 ， 并 且 是 使 用 .NET 
Framework 支持 的 语言 编写 的 。 当 和 面 同 .NET Standard 类 库 时 同样 如 此 。 


共享 项 目 、PCL 和 .NET Standard 


在 .NET Standard 和 可 移植 类 库 (PCL)( 稍 后 将 进行 讨论 ) 出 现 之 前 ， 有 一 个 共 侍 项 目的 概念 ， 在 共 圣 项 目 中 ， 
WAITH, else 和 #endif 指令 来 标识 代码 运行 在 什么 软件 或 硬件 平台 上 ， 然 后 为 对 应 平台 加 载 正 确 的 程序 集 。 
例如 ， 和 正面 的 代码 段 检 查 平台 是 不 是 NET Framework 4.0. WREE, mbH System.Net; 如 果 不 是 ， 就 引用 
System Net Http( 代 码 假定 没有 比 4.0 更 早 的 NET Framework 版 本 )。 后 面 ， 在 代码 或 类 文件 中 ， 开 发 人 员 必须 再 
次 检查 平台 依赖 ， 并 调用 那些 类 中 的 方法 来 实现 程序 的 目标 ， 如 使 用 WebClient0 或 HttpClient0 方 法 。 这 些 方法 
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处 理 传 出 或 传 入 的 HTTP 请 求 和 响应 。 加 载 的 NET Framework 的 版 本 不 同时 ， 这 两 个 方法 的 实现 会 有 区 别 。 
fif NET4O 
using System.Net; 
#else 
using System.Net.Http; 
using System. Threading.Tasks; 
endif 


除了 软件 运行 时 验证 ， 开 发 人 员 还 可 以 使 用 那些 指令 (#f、#else、#endlif) 来 检查 不 同 的 硬件 平台 ， 并 基于 
检查 结果 加 载 特定 的 二 进 制 文件 。 
#if PLATFORM X6 4 
[DllImport ("BLIB64.d11", CallingConvention-CallingConvention.cdecl)] 
#else 


[DllImport ("BLIB32.d11", CallingConvention-CallingConvention.Cdecl)] 
#endif 


使 用 胡 f、#else 和 #endif 指令 来 提供 器 平台 文 持 ， 从 来 不 是 一 种 可 徘 的 、 可 扩展 的 、 可 维护 的 或 易于 文 持 的 
方法 。 程 序 有 许多 代码 路 径 ， 当 软件 或 硬件 组 件 发 生变 化 时 ， 需 要 进行 大 量 更 新 ， 并 执行 复杂 的 测试 过 程 。 随 
者 对 面 问 多 个 垂直 柳 型 和 平台 的 需求 增加 ， 非 营 需 要 一 种 新 的 解决 方案 来 实现 路 平台 文 持 。 这 种 需求 众生 了 可 
移植 类 库 (PCL) 的 概念 。PCL 在 很 大 程度 上 帮助 解决 了 扩展 、 维 护 、 测 试 和 可 支持 性 问题 。 创 建 PCL 时 ， 开 发 
人 员 可 从 一 个 列表 中 选择 要 面向 的 垂直 模型 (如 图 18-2 所 示 ), 使 用 的 工具 (如 Visual Studio) 将 在 不 同 应 用 程序 模 
型 的 BCL 中 生成 API。 注 意 ， 还 可 安装 秆 外 的 目标 ， 如 Xamarin, Unity 以 及 完整 .NET Framework 的 其 他 文 持 
版 本 。 


Targets: 


[7] .NET Framework 4.6 
ASP.NET Core 1.0 
Windows Universal 10.0 


Install additional targets... 


A The selection makes this project incompatible with 
Visual Studio 2013 and lower. 


Cancel 


图 18-2 


如 果 仍 在 Windows 堆栈 和 生态 系统 中 进行 开发 ，PCL 的 效果 很 好 。 问 题 在 于 ，Windows 操作 系统 的 一 些 功 
能 是 这 个 操作 系统 独 有 的 。 例 如 ， 注 册 表 就 是 这 样 的 一 个 功能 ， 其 他 操作 系统 要 么 没有 这 种 功能 ， 要 人 么 虽然 有 
类 似 的 功能 ， 但 区 别 很 大 ， 以 至 于 不 能 使 用 为 读 写 Windows 注册 表 设 计 的 PCL。 另 外 ，Windows 实现 反射 的 方 
式 与 其 他 操作 系统 不 同 ， 并 且 应 用 程序 域 ( 如 AppDomain) 的 概念 也 与 其 他 操作 系统 不 同 。 在 Windows 中 ， 
AppDomain 是 进程 内 的 一 个 隔离 层 。 因 此 ， 使 用 PCL 确实 帮助 解决 了 针对 多 个 Windows 垂直 模型 进行 开发 的 
问题 ， 但 并 没有 实现 完全 的 软件 和 人 硬件 跨 平 台 文 持 。 

Microsoft 给 出 的 解决 办 法 是 创建 .NET Standard 库 和 .NET Core( 关 于 .NET Core 的 细节 , 请 参见 下 一 节 )。NET 
Standard 是 一 组 NET API， 设 计 目 标 是 可 用 于 所 有 .NET 垂直 模型 。 如 图 18-3 所 示 ， 它 取代 了 每 个 分 支 或 框架 
垂直 模型 中 特定 于 BCL 的 实现 细节 。.NET Standard 类 库 将 所 有 .NET Framework 垂直 模型 的 BCL 统一 起 来 。 
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NET 
NET Framework Framework NET Micro NET .NET Core Mono 


for Compact 
Framework P 


SilverLight Framework 
公 共 语 言 运 行 库 (CLR) CoreCLR NET Native/CoreFX | Android/iOS/OS X 


Universal 
Windows Apps Aamarin 
(UWP) 


Windows ASPNET WPE Silverlight Windows ASPNET 
Forms Phone Core 


NET Standard EE 


公共 基础 设施 
运行 库 编译 器 组 件 


图 18-3 


在 PCL 中 创建 类 时 ， 程 序 员 需 要 选择 面向 哪个 NET Framework 77 3: (Compact. Micro. Silverlight. Core 
等 )， 与 之 相似 ， 当 创建 .NET Standard Class Library 时 ， 需 要 选择 .NET Standard 的 目标 版 本 。 如 下 一 节 所 
述 ， 程 序 员 根据 期 望 使 用 的 目标 框架 来 选择 .NET Standard 版 本 ， 版 本 越 高 ， 能 运行 应 用 程序 模型 的 平台 数 
量 越 少 。 

最 后 , .NET Standard 1.0 版 本 公开 的 API 较 少 ; 但 是 , 随 着 .NET Standard 2.0 的 发 布 , API 数量 达到 了 33 000 
左右 。 可 以 把 API 视 为 NET Framework 名 称 空 间 内 包含 的 方法 。 表 18-2 概述 了 文 持 的 名 称 空间 以 及 其 中 可 用 


的 API 数量 。 
表 18-2 .NET Standard 2.0 的 名 称 空间 和 API 数量 概览 
名 称 空 间 API 数量 

System 1087 

System.Collections 292 

System.Data 1399 

System.IO 275 

System.Net 1271 

System.Security. Authentication 11 

System. Web 32 

System. XML 1011 


要 得 看 .NET Standard 2.0 中 可 用 API 的 详细 列表 ， 请 访问 https://github.com/dotmet/standard/blob/ 
master/docs/versions/netstandard2.0.md。 现 在 ， 我 们 已 经 解释 了 了 .NET Standard 类 库 的 用 途 ， 以 及 业界 对 路 平台 文 持 
的 需求 逐渐 增长 的 历史 。 但 是 ，.NET Standard 类 库 仍 然 非 党 侧重 Windows 堆栈 ， 因 此 ，.NET Core 框架 分 支出 
现 了 。 


18.3 引用 和 目标 框 染 


在 决定 实现 哪个 版 本 的 .NET Standard 时 ， 决 定 因 素 是 类 库 必须 运行 在 什么 平台 和 框架 上 。 如 表 18-3 所 
示 ， 选 择 的 .NET Standard 的 版 本 越 高 ， 可 用 的 API( 参 见 表 18-2) 越 多 ， 但 能 运行 该 类 的 平台 也 越 少 。 


#188 .NET Standard 与 .NET Core | 403 


% 18-3 .NET Standard 支持 的 版 本 小 结 


框架 

.NET Standard 1.1 1.2 1.4 1.5 2.0 
.NET Core 1.0 1.0 1.0 1.0 2.0 
.NET Framework (.NET Core 2.0) 4.5 4.5.1 4.6.1 4.6.1 4.6.1 
Mono 4.6 4.6 4.6 4.6 54 
Xamarin.1OS 10 10 10 10 10.14 
Xamarin. Android 7.0 7.0 7.0 7.0 8.0 
UWP 10 10 10 vNext vNext 


设想 这 样 一 个 场景 : NET Standard 类 库 需 要 运行 ， 面 同 的 是 .NET Core 1.0. NET Framework 4.5.1 和 
Xamarin.Android 7.0 框架 。 这 种 情况 下 ，.NET Standard 类 库 必须 面向 .NET Standard 1.2 版 本 ， 因 为 此 版 本 支持 
上 述 所 有 框架 。 考 虑 男 一 个 场景 :仍然 需要 和 面 同上 述 所 有 框架 ， 只 是 需要 的 .NET Framework 版 本 是 4.6.1。 此 
时 ，NET Standard 类 库 应 该 面向 版 本 1.4。 如 果 .NET Framework 需要 侧重 在 4.5 版 本 上 ， 则 应 该 知道 的 是 , 4.6.1 
版 本 中 也 具有 4.5 版 本 的 功能 。 旧 版 本 的 API 也 包含 在 了 新 版 本 中 ， 所 以 不 需要 疝 下 降级 。 

不 同 NET Standard 版 本 中 提供 的 API 存 在 巨大 区 别 。 如 表 18-2 所 示 ，NET Standard 2.0 中 的 API 数量 相当 
大 ， 有 33 000 个 左右 ， 而 1.0 版 本 中 提供 的 API 则 要 少 得 多 。 因 此 ， 当 面 回 1.0 版 本 时 ， 能 够 访问 执行 程序 所 
需 的 API 的 可 能 性 要 比 面 回 2.0 版 本 时 更 小 。 很 多 情况 下 ,“ 较 老 的 ”共享 项 目 或 PCL 面向 的 是 较 早 的 NET 
Framework 版 本 ， 而 它们 并 没有 被 移植 到 NET Standard 中 。 这 意味 着 那些 项 目 中 的 代码 将 无 法 运行 ， 可 能 是 因 
为 API 不 存在 、 已 被 明显 修改 或 根本 不 被 文 持 。 


18.4 .NET Core 的 含义 


前 面 提 到 ，.NET Standard 是 用 于 所 有 Windows 垂直 模型 的 一 个 类 库 ，.NET Core 就 是 这 样 的 一 个 垂直 
模型 。.NET Core 是 完整 的 、 功 能 丰 宣 的 .NET Framework 的 一 个 分 文 ， 并 且 是 路 平台 和 开源 的 。 另 外 ，.NET 
Core 针对 在 云 平台 (如 Microsoft Azure) 上 运行 做 了 优化 ， 并 且 是 模块 化 的 ， 性 能 很 好 ， 采 用 了 真正 独立 的 部 
署 模型 。 

注意 : 

对 于 开发 在 Windows 操作 系统 上 运行 ， 功 能 丰富 并 且 基 于 Windows fe ASP.NET 的 应 用 程序 来 说 ,完整 版 
本 的 NET Framework 仍然 是 最 好 的 选择 ， 


NET Core 框架 是 Microsoft 提供 的 开发 垂直 模型 的 最 新 成 员 ， 将 成 为 未 来 所 有 开发 的 首选 框架 。 
在 下 面 的 “ 试 一 试 ” 中 ， 将 安装 NET Core 2.0， 它 包含 NET Standard 2.0. 


iX—iX NET Core 2.0 SDK 


你 需要 将 Visual Studio 2017 更 新 到 人 至少 update 3， 并 安装 NET Core 2.0.0 Runtime 和 SDK， 此 后 才能 基 
于 .NET Core 2.0.0 创建 NET Standard 2.0 类 库 和 .NET Core 应 用 程序 。 

(1) 在 Visual Studio 2017 中 ， 单 击 Help | About Microsoft Visual Studio. 

(2) 如 果 Visual Studio 的 版 本 大 于 或 等 于 15.3， 则 和 直接 跳 到 第 (5) 步 。 

(3) 选择 Tools | Extensions and Updates 订单 项 ， 然 后 展开 Updates 树 视图 项 ， 如 图 18-4 所 示 。 
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^ Installed 


lin | 
rime 4) — — a Created by: Microsoft Corp. 
components, and servicing fixes issued. Current Version: 15026430 16 
Product Updates (1) New Version: 15.326730.15 
Release Notes 
Visual Studio Marketplace (1) 


Updates (2) 


' Roaming Extension Manager 


Change your Extensions and Updates settings 


图 18-4 


(4) 安装 Visual Studio Update. 

(5) 从 https://www.microsoft.com/net/download/windows F #%.NET Core Runtime 2.0.0. .NET Core SDK 2.0.0 
或 更 新 版 本 ， 然 后 安装 。 或 者 ， 可 从 GitHub 存储 库 下 载 : https://github.com/dotnet/core/tree/master/release-notes/ 
download-archives。 


(6) 现在 , 在 Visual Studio 项 目的 Properties 选项 卡 中 , 可 选择 .NET Core 2.0 和 .NET Standard 作为 目标 框架 。 


示例 说 明 
根据 安装 的 位 版 本 ，NET Core 2.0 SDK 可 能 安装 到 C:\Program Files\dotnet 或 C:\Program Files (x86)\dotnet H 
录 中 (如 图 18-5 所 示 )。 本 例 在 Windows 10 计算 机 上 使 用 Visual Studio Community 版 本 。 目前 , 没有 将 .NET Core 
安装 到 Mac BK Linux 上 的 Visual Studio Code 的 示例 。 
All .NET Core downloads 


SDK Runtime 


-NET Core 2.0 SDK 


Windows (x64) Installer exe download 


Windows (x86) Installer 


exe download 


macOS (x64) PKG pkg download 


Linux tar.gz downloads 


图 18-5 
本 章 剩 余部 分 将 介绍 使 NET Core 2.0 成 为 新 的 Microsoft HB BINA IER e 
1841 EFS 


如 表 18-1 所 示 , 跨 平 台 指 的 是 编写 代码 一 次 , 就 可 以 在 任何 文 持 的 硬件 和 软件 平台 上 运行 这 些 代 码 。 但 是 ， 
必须 将 对 应 的 硬件 和 软件 平台 作为 目标 来 编 诺 代码， 并 包 舍 特定 的 运行 库 。 不 过 ， 代 码 只 需要 编写 一 次 。 如 图 
18-5 PrzR, NET Core 2.0 SDK 可 下 载 到 Windows(x64). Windows(x86). macOS 和 Linux 上 。 

要 在 Windows. macOS 或 Linux 上 使 用 NET Core SDK， 需 要 有 一 台 运 行 相 应 操作 系统 的 计算 机 ， 并 且 需 
要 有 一 个 支持 .NET Core SDK 的 IDE 来 处 理 代码 。 对 于 使 用 .NET Core 进行 开发 ，Visual Studio Code 是 一 个 非 
第 诉 行 的 IDE， 其 下 载 地 址 为 https:Wcode visualstudio.com( 如 图 18-6 所 示 )。Visual Studio Code 能 调试 功能 ， 并 文 
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持 智 能 感知 功能 。 
Download Visual Studio Code 


Free and open source. Integrated Git, debugging and extensions. 


9 


到 目前 为 止 ， 本 书 中 的 练习 都 使 用 了 Visual Studio Community. AlAA STAIN Microsoft 技术 ， 并 在 
Windows 操作 系统 上 完成 练习 , 所 以 仍 将 使 用 Visual Studio Community. 但 毋庸 置疑 , 使 用 针对 Windows 的 .NET 
Core 框架 在 Windows 计算 机 上 编写 的 代码 ， 也 可 以 在 Mac Bk Linux 机 右上 编译 和 执行 。 

必须 重申 一 点 : 必须 针对 为 目标 操作 系统 编译 的 System.IO.dll, 编译 特定 于 操作 系统 的 功能 , 例如 System.IO 
名 称 空间 中 包含 的 功能 。 因此 ， 如 果 在 Linux 计算 机 上 使 用 Visual Studio Code 创建 一 个 项 目 , 并 包含 System.IO 
名 称 空间 ， 那 么 该 名 称 空 间 将 是 在 Linux OS 上 运行 项 目 必 需 的 名 称 空间 。 本 和 章 稍 后 将 介绍 的 NuGet 可 帮助 确 
保 项 目 得 到 适合 对 应 平台 的 正确 二 进 制 文件 。 
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NET Core 框架 的 源 代码 放 到 了 如 下 地 址 ;https://github.com/dotnet/core。 任 何 开 发 人 员 ( 或 者 任何 有 能 力 证 
代码 的 人 ) 都 可 以 三 看 其 源 代码 ， 了 解 它 实 现 的 操作 。 男 外 ,开发 人 员 可 与 其 他 开发 人 员 合 作 , 在 源 代码 中 查找 、 
确认 甚至 修复 bug 或 问题 。 注 意 ， 完 整 NET Framework 的 源 代 公 地 址 为 http://referencesource.microsoft.com, 但 
它 不 是 开源 的 ， 因 此 既 不 能 创建 其 分 文 ， 也 不 能 构建 /编译 这 个 完整 框架 的 一 个 版 本 。 不 要 误 认为 只 有 克隆 或 下 
载 .NET Core GitHub 存储 库 后 生成 并 编译 ， 才 能 使 用 .NET Core。 如 前 所 述 (参见 图 185), A FOE EAE 
Microsoft 创建 的 一 个 稳定 编译 版 本 。 

如 果 发 现 .NET Core 源 代码 中 缺少 一 个 方法 或 类 ， 或 者 让 应 用 程序 能 够 以 最 优 方 式 运行 的 其 他 东西 ， 就 可 
以 自行 添加 ， 而 这 正 是 开源 的 好 处 。 当 创建 分 文 时 ， 添 加 代码 优化 ， 并 让 社区 知道 你 做 了 代码 优化 。 如 果 社 区 
接受 你 做 的 优化 ， 融 可 以 把 它 放 到 主 分 文中 ， 并 包 舍 在 下 一 个 版 本 中 。 如 果 优 化 未 被 接受 ， 就 仅 为 需要 该 优化 
的 项 目 编 详 和 生成 一 个 NET Core 框架 版 本 。 

最 后 ， 通 过 使 NET Core 框架 开源 ，Microsoft 让 开发 人 员 和 设计 师 组 成 的 开放 社区 真正 参与 进来 ， 为 他 们 
提供 一 个 极 好 的 机 会 来 做 页 献 ， 信 此 扬名 ， 从 而 利用 技能 提升 目 己 的 职业 机 会 。 像 这 样 主要 由 Microsoft 开发 人 
员 编 写 的 代码 在 以 前 对 开放 社区 是 封闭 的 。 


1843 ”针对 云 进行 优化 


第 16 章 介 绍 针对 云 进行 了 优化 的 堆栈 。 定 义 云 优化 的 堆栈 的 特性 包括 : 
e 可 移植 性 
e 可 扩展 性 
口 小 而 简洁 
黄 块 化 (并 行 执行 ) 
e 弹性 
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NET Core 是 可 移植 的 ， 并 且 是 完全 器 平台 的 。 由 于 占用 空间 小 (相对 于 完整 的 .NET Framework 肯定 如 此 )， 
它 也 是 可 扩展 的 。 当 编译 .NET Core 程序 时 ， 只 会 把 运行 程序 需要 的 二 进 制 文件 打包 到 程序 集 或 可 执行 文件 中 ， 
所 以 非常 容易 在 其 他 云 硬件 上 复制 和 运行 程序 。 由 于 .NET Core 的 代码 是 完整 NET Framework 的 一 个 分 支 ， 而 
完整 的 NET Framework 是 经 过 时 间 验 证 的 、 精 心 设计 开 肥 的 编程 库 ， 所 以 代码 对 于 暂时 性 问题 和 处 理 的 异常 表 
现 出 弹性 恢复 能 力 。 更 多 信息 请 参见 16.2 节 “ 云 模式 和 最 佳 实践 ”。 

NET Core 库 和 运行 库 的 大 小 和 速度 也 已 被 优化 。 在 云 中 ， 有 用户 需要 按照 使 用 量 (如 资源 消耗 量 ) 付 费 ， 
因此 这 一 点 束 非 党 重要 。 因 此， 如 果 程 序 占用 的 空间 小 ， 运 行 速度 快 ， 青 要 的 计算 能 力 束 少 ， 成 本 会 随 之 
降低 。 


18.4.4 性 能 


相对 于 完整 的 NET Framework, .NET Core 提供 了 许多 性 能 改进 。 关 于 优化 的 许多 想法 都 源 目 开源 社 
区 。 现 在 ， 开 发 人 员 不 必 设 法 统 过 性 能 问题 ， 而 可 枉 看 导致 程 序 运 行 缓慢 的 源 代码 ， 并 直接 优化 代码 。 在 
COREFX 和 CORECLR GitHub 存储 库 中 查找 包含 performance 的 请 求 , 会 看 到 数 千 个 修改 。 表 18-4 给 出 了 一 


些 示 例 。 
表 18-4 .NET Core 相 比 于 .NET Framework 所 做 的 性 能 改进 
名 称 空间 /模块 性 能 改进 
System.Runtime.Serialization 12 倍 
System.Security.Cryptography 2 倍 
System.IO.Compression 4 fit 
System.Linq 最 高 30 fi 
System.Collections.Concurrent.CollectionBag<T> 30% 
System.Collections.Generic.List<T> 25% 
System.Collections.Generic.SortedSet<T> 600 fi 
System.Collections.Generic.Queue- T^ 2 倍 
System.Text.RegularExpressions 25% 


己 被 实现 的 优化 有 很 多 ， 而 随 厦 更 多 开发 人 员 和 公司 采用 .NET Core 并 为 其 做 页 献 ， 这 个 库 会 变 得 越 来 越 
好 。 在 以 下 网 址 可 查看 关于 .NET Core 的 性 能 改进 的 讨论 : https://blogs.msdn.microsoft.com/dotnet/2017/ 
06/07/performance-1improvements-1n-net-core/ . 
18.4.5 ”模块 化 设计 

当 创 建 一 个 新 的 .NET Core 2.0 项 目 时 (下 一 个 “ 试 一 试 ” 将 完成 此 操作 )， 项 目 中 将 包含 一 组 “标准 ” 
ikti. EJF Dependencies | SDK | MicrosoftNetCore.App， 残 可 以 看 到 这 些 依赖 ， 如 图 18-7 Prax. BATH 
目 中 包含 超过 100 个 程序 集 ， 但 编 详 后 ， 其 程序 集 或 可 执行 文件 中 只 会 包含 运行 程序 必需 的 和 已 引用 的 
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六部- o- 


Search Solution Explorer (Ctrl «ü) 


4 @ chapter18 
P E] Ch18CardClientCore 
P [e Ch18CardLibStandard 
4 [Ed Ch18bx01 
4 oo Dependencies 
4 35 SDK 


4 È% MicrosoftNETCore App 
b € Microsoft.NETCore.DotNetHostPolicy (2.0.0) 
‘@ Microsoft NETCore Platforms (2.0.0) 
*8 Microsoft.CSharp.dll 
=E Microsoft. VisualBasic.dll 
eE Microsoft. Win32.Primitives.dll 
"E mscorlib.dll 
*-B netstandard.dll 
"B System.AppContext.dll 
Solution Explorer Team Explorer 
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NET Core 通过 一 组 NuGet 包 交 付 。 包 含 “ 标 准 的 ”或 “默认 的 ”项 目 程序 集 是 为 了 文 持 茶 种 场景 ， 如 开 
发 人 员 的 计算 机 没有 连接 到 Intemet， 所 以 无 法 下 载 和 安装 基本 的 NuGet 包 。 但 在 创建 NET Core 2.0 MH JA, 

在 下 和 面 的 “ 试 一 试 ” 中 ， 将 创建 一 个 Console App CNET Core)， 并 使 用 NuGet 添加 一 个 没有 包含 在 默认 项 
日 程序 集 集合 中 的 .NET Core &.. 


试 一 试 ”创建 一 个 Console App (.NET Core)， 并 安装 一 个 面向 .NET Core 的 NuGet 包 
Ch18Ex01\Program.cs 


(1) 在 Visual Studio 中 选择 File | New | Project...， 创建 一 个 新 的 Console App (NET Core) 应 用 程序 。 在 New 
Project 对 话 框 (如 图 18-8 所 示 ) 中 ， 选 择 Visual C#| NET Core， 然 后 选择 Console App CNET Core) 模 板 。 将 路 径 
改 为 C:\BeginningCSharp7\Chapter18， 将 该 控制 台 应 用 程序 命名 为 Ch18Ex01， 然 后 单 击 OK 按钮 。 


b Recent NET Framework 4.7 - Sortby: Default sa" |22] Search (Ctri+E) P- 


4 installed Type: Visual C# 


4 Visual C# a A project for creating a command-line 
Windows Classic Desktop | Class Library (NET Core) Visual C# application that can run on .NET Core on 
Web pem Windows, Linux and MacOS. 


.NET Core aN Unit Test Project (.NET Core) Visual C$ 
.NET Standard 


Cloud xUnit Test Project (NET Core) Visual Cs 


Test 
Not finding what you are looking for? 


Open Visual Studio Installer 


ASP.NET Core Web Application Visual C# 


Name: Ch18Ex01 
Location: CABeginningCSharp7XChapter18 
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(2) 展开 Dependencies | SDK | Microsoft.NetCore.App， 如 图 18-7 所 示 ; 注意 ， 这 里 没有 Newtonsoft Json f£ 
序 集 。 
(3) 要 使 用 NuGet Package Manager 2 iZ%Fe/P Se, EKAP Ah Tools | NuGet Package Manager | Package 


Manager Console. 
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Install-Package Newtonsoft.Json 

(5) 安装 完毕 后 ， 会 在 Dependencies 下 创建 一 个 名 为 NuGet 的 新 文件 来 。 展 开 该 文件 来 ， 可 看 到 模块 
NewtonsoftJson。 现 在 ， 通 过 在 Program.cs 顶部 添加 下 面 一 行 代 码 ， 就 可 以 在 项 目 中 引用 该 模块 了 : 

using Newtonsoft.Json 

(6) 477% Ch18Ex01 项 目 ， 选 择 Edit Ch18Ex01.csproj， 注 意 项 目 中 已 经 添加 了 对 Newtonsoft.Json NuGet 包 
的 引用 。 


示例 说 明 

如 表 18-1 所 示 ，.NET Core 的 包 和 模块 是 使 用 语义 版 本 进行 版 本 化 的 。 例 如 ， 经 常 看 到 对 程序 集 进 行 这 样 
的 引用 : type=Newtonsoft.Json, version=10.0.3, Culture=neutral, PublicKeyToken- 30ad4fe6b2a6aeed。 如 果 由 于 某 
种 原因 ， 版 本 号 不 同步 ， 在 编 详 或 者 运行 时 出 现 这 样 的 错误 : 

"Could not load file or assembly 'Newtonsoft.Json, Version=10.0.2, 
Culture-neutral,PublicKeyToken-30ad4fe6b2a6aeed' or one of its dependencies. The system cannot find the 
file specified. 

NET Core 基于 NuGet 的 新 模块 化 设计 能 帮助 快速 解决 这 种 复杂 问题 。 之 前 ， 人 处 理 此 类 异 第 的 难点 在 于 找 
出 在 什么 地 方 配置 了 引用 ， 然 后 找 出 在 什么 地 方 修改 了 引用 ， 可 能 还 需要 确定 为 什么 修改 引用 。 之 后 ， 需 要 
在 正确 位 置 添加 程序 集 的 正确 版 本 ， 使 引用 能 匹配 已 安 沪 的 程序 集 ， 在 很 长 一 段 时 间 里 ， 这 都 是 令 人 头痛 的 
问题 。 

解决 这 个 问题 的 方法 是 ， 在 Install-Package NuGet 命令 中 添加 -Version 参数 ， 这 将 安装 .NET Core 项 目 所 引 
用 的 版 本 。 


Install-Package Newtonsoft.Jcon -Version 10.0.2 


使 用 NuGet 安装 包 ， 并 且 指 定 程序 集 和 版 本 号 ， 使 得 NET Core 变 得 模块 化 。 这 种 模块 化 设计 对 于 下 一 节 
讨论 的 应 用 程序 部 署 和 框架 更 新 架构 产生 了 巨大 影响 。 


18.4.6 ”独立 的 部 署 模型 


完整 的 NET Framework 最 律 被 安装 到 将 运行 开发 人 员 创 建 的 程序 的 计算 机 或 服务 器 上 。 这 人 么 做 的 一 个 好 处 
是 ， 只 需要 安 凑 框 架 一 次 ， 所 有 应 用 程序 就 可 以 根据 需要 引用 和 使 用 该 框架 ， 从 而 节省 本 地 存储 空间 。 但 是 ， 
有 可 能 发 生 这 样 一 种 不 期 望 遇 到 的 场景 : 所 有 的 应 用 程序 引用 相同 的 框架 程序 集 ， 但 是 程序 集 被 意外 更 新 ， 破 
坏 了 一 些 代 码 功 能 。 

对 于 完整 的 NET Framework， 有 两 种 差别 很 大 的 升级 类 型 : 并 行 和 就 地 升级 。 并 行 升 级 代表 主 版 本 的 变化 。 
例如 , 222 NET Framework 2.0 和 NET Framework 4.0 可 文 持 基 于 2.0 BK 4.0 版 本 的 程序 。 当 CLR 和 框架 组 件 发 
生 重 要 修改 或 优化 时 ， 可 能 出 现 这 种 情形 。 如 果 一 个 程序 面 癌 .NET Framework 2.0， 但 是 安装 的 是 NET 
Framework 4.0， 那 么 产生 影 啊 的 风险 很 小 ， 因 为 这 两 个 版 本 是 并 行 安 计 的 。 与 之 相对 ， 就 地 升级 (例如 从 .NET 
Framework 4.5 升级 到 NET Framework 4.6.2)， 则 可 能 包含 对 mscorlib.dll 和 其 他 .NET 程序 集 的 修改 ， 而 当 程 序 
ffl |=]. NET Framework 4X 时 ， 是 需要 运行 这 些 文件 的 。 

NET Core 通过 实现 独立 性 (也 称 为 应用 程序 本 地 框架 ) 解 决 了 这 个 问题 。 应 用 程序 本 地 框架 的 食 义 是 , 程 厅 
内 引用 的 程序 集 与 模 其 或 可 执行 文件 包含 在 一 起 ， 当 部 着 程序 后 ， 程 序 包含 运行 时 需要 的 所 有 程序 集 ( 运 行 库 、 
编译 纪 和 引用 的 框 和 架 组 件 )。 程 序 不 再 依赖 于 在 机 器 范围 内 安 眶 的 任何 .NET Framework， 对 机 右 范 围 内 的 .NET 
Framework 版 本 所 做 的 任何 并 行 或 就 地 修改 ， 不 会 影响 .NET Core 程序 。 最 后 ， 因 为 程序 集 很 小 、 很 简洁 (如 针 
对 云 优化 )， 所 以 占用 的 本 地 存储 空间 有 限 。 

这 意味 着 对 于 开 友 人 员 和 公司 来 说 ， 当 交付 产品 后 ， 他 们 可 以 确信 即使 在 计算 机 或 服务 右上 升级 框 浪 ， 程 
序 也 仍 将 继续 工作 。 在 过 去 ， 当 发 生 破 坏 性 升级 后 ， 开 友人 员 和 开 文 持 人 员 要 参加 问题 升级 会 议 ， 在 危机 状态 
下 解决 程序 无 法 继续 运行 的 问题 。 在 企业 中 ， 这 是 非常 复杂 的 情形 ， 因 为 小 组 、 团 队 和 流程 要 想 修改 生产 环境 ， 
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变 得 复杂 和 需要 获得 批准 的 根源 所 在 。 这 些 限制 使 得 问题 更 具 挑 战 性 。 


注意 : 

相对 于 .NET Framework 需要 在 机 器 范围 内 进行 修改 ， 在 开发 环境 中 升级 和 回 滚 NET Core 很 简单 。 要 升级 
到 最 新 版 本 的 .NET Core 模块 ， 执 行 此 命令 即 可 : installpackage System.TextRegularExpressions。 要 回 滚 到 前 一 个 
版 本 ， 可 使 用 -Version 参数 来 指定 目标 版 本 。 


而 选择 .NET Core 作为 框架 时 ， 这 种 危机 场景 将 不 会 及 生 。 相 反 ， 升 级 只 在 应 用 程序 级 别 进行 ， 在 升级 之 
前 ， 可 先进 行 大 量 的 开 友 、 集 成 和 性 能 测试 。 如 果 升 级 到 新 的 程序 集 版 本 时 ， 在 开 肥 周期 中 友 现 了 问题 ， 开 有 友 
人 员 和 公司 可 决定 采取 什么 行动 。 在 开发 环境 中 决定 升级 代码 来 文 持 新 版 本 ， 或 者 回 深 到 升级 前 能 民 好 工作 的 
版 本 ， 要 比 在 生产 危机 情形 下 做 决定 更 容易 。 


18.5 ”生成 和 打包 .NET Standard EE 


NET Standard 类 库 是 一 个 BCL, 可 运行 在 多 种 不 同 的 竺 直 模 型 中 。 在 下 面 的 “ 试 一 试 ” 中 , 将 创建 一 个 .NET 
Standard 类 库 ， 它 包含 处 理 纸牌 所 宕 的 类 。 


试 一 试 ”创建 一 个 .NET Standard KE 


下 面 将 使 用 Visual Studio 2017 创建 一 个 .NET Standard 类 库 , 它 包含 本 书 讲解 的 纸牌 游戏 示例 用 到 的 一 些 类 。 

(1) f£ Visual Studio 中 ， 选 择 File | New | Project...， 创 建 一 个 新 的 .NET Standard 类 库 。 在 New Project 对 话 
框 ( 如 图 18-9 所 示 ) 中 ， 选 择 Visual C£ | NET Standard， 然 后 选择 Class Library (NET Standard) 模 板 。 将 路 径 改 为 
Ci\BeginningCSharp7\Chapter18， 将 Class Library 命名 为 Ch18CardLibStandard， 然 后 单 击 OK 按钮 。 


b Recent NET Framework 4.7 ~ Sort by: Default = Search Installed Temp! # ~ 


4 |nstalled aa) | Ts ! 
x Class Library (NET Standard) Visual C# Type: Visual Cs 
LI 


4 Visual C# A project for creating a class library that 
Windows Classic Desktop targets .NET Standard. 
Web 
NET Core 
.NET Standard 
Cloud 
Test 
WCF 
P Azure Data Lake 


b Other Languages 


Not finding what you are looking for? 


Open Visual Studio Installer 


b Online 


Name: Ch18CardLibStandard 


Location: C:\BeginningCSharp7\Chapter18\ 


3] 18-9 
(2) 因为 不 需要 的 认 类 ， 所 以 右 击 Classl.es 文件 (这 是 献 认 创建 的 文件 )， 选 择 Delete KED, LORNA 


中 删除 该 类 。 
(3) 从 在 线 存储 库 中 下 载 示例 代码 (本 章 开 头 给 出 了 下 载 地 址 )， 然 后 在 Ch18CardLibStandard 项 目的 根 目 录 
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中 添加 下 面 的 类 文件 。 添 加 方法 是 右 击 Ch18CardLibStandard 项 目 ， 选 择 Add | Existing Item...， 然 后 选择 下 载 
的 示例 中 的 7 个 类 。 
a. Card.cs 
. Cards.cs 
Deck.cs 
. Game.cs 
. Player.cs 


. Suit.cs 


中 mo o c 


注意 : 

这 7 个 类 与 Ch13CardClient 和 Ch13CardLib 中 的 类 相似 ， 只 是 做 了 一 些 修改 ， 例 如 移 除 了 WriteLine0 和 
ReadLineO 方 法 以 及 其 他 一 些 多 余 的 方法 。 

(4) 如 图 18-10 所 示 ， 将 项 目 设 为 Release 模式 ， 然 后 右 击 项 目 并 选择 Properties, f£ Ch18CardLibStandard 
项 目的 Properties 选项 卡 中 确认 将 Target framework 设 为 NET Standard 2.0. 


ad BeginningCSharp/ - Microsoft Visual Studio 
File Edit View Project Build Debug Team Tools Test Analyze Window Help 


o - BS-cgaF o-c- Release M Any CPU ~ Ch18CardLibStandard - b Chi8CardLibStandard ~ 


p" Pa f = d í Debug 
Ch1 BC ard ibStandard = H 
i Release 


Application et Configuration Manager... | 


nfiguration: A Platform: MM 


Build 

Build Events Assembly name: Default namespace: 
Package (Ch18CardLibStandard | chi &CardLibStandard 
Debug Target framework Output type: 

signing .NET Standard 2.0 Class Library 


Resources 


jajoldx3 pnoly xogjooL 


Startup object 
(Not set) 
Resources 
Specify how application resources will be managed: 


@ Icon and manifest 


A manifest determines specific settings for an application. To embed a custom manifest, first 
add it to your project and then select it from the list below. 


Icon: 
(Default Icon) 
Manifesl 


Embed manifest with default settings 


(C) Resource file: 


图 18-10 


(5) 单 击 Build 子 选项 卡 ( 位 于 几 18-10 Application 子 选项 卡 的 下 方 )。 选 中 Generate documentation file 
复 选 枉 ， 然 后 保存 。 

(6) 按 Shift+F6， 或 从 工具 栏 中 选择 Build | Build Chl18CardLibstandard， 生 成 /重新 生成 项 目 。 

(7) 查看 Ch18CardLibStandard 下 的 bin\Release\netstandard2.0 目录 中 的 输出 , 确认 生成 项 目的 操作 成 功 生 成 
f XML 和 DLL 文件 。 

PUA! 现在 已 成 功 创建 了 一 个 .NET Standard 类 库 。 
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示例 说 明 

虽然 这 个 “ 试 一 试 ” 面 同 的 是 .NET Standard 2.0， 但 是 CardLib 库 中 的 API 并 不 要 求 必须 使 用 只 有 .NET 
Standard 2.0 才 文 持 的 框架 中 的 API。 这 意味 看 在 现实 使 用 中 ，.NET Standard 版 本 可 以 运行 在 1.0 版 本 上 ， 从 而 
能 在 更 多 平台 上 使 用 。 

第 (5) 步 让 你 选中 复 选 框 ， 以 创建 XML 文档 。 生 成 的 XML 文档 中 的 信息 来 日 类 文件 内 的 summary 内 容 。 
这 些 信息 用 于 在 发 布 和 打包 NuGet 包 时 (本 章 稍 后 将 介绍 ) 自 动 生成 描述 。 例 如 ， 在 Cardes 中 有 下 面 这 样 的 
summary: 

/// <summary> 

/// Class that describes a single card 


/// </summary> 


M<summary> 和 </summary> 标 签 之 间 的 内 容 代表 XML 文档 的 内 容 。 现 在 我 们 已 经 创建 了 NET Standard 
类 库 ， 接 下 来 打包 并 把 它 部 署 到 NuGet， 以 便 所 有 文 持 的 垂直 模型 、 平 台 和 处 理 器 都 能 使 用 它 。 


在 下 面 的 “ 试 一 试 ” 中， 将 打包 上 一 个 练习 中 创建 的 NET Standard 类 库 。 本 章 后 面 的 NET Core 应 用 程序 ， 
以 及 第 19 章 的 ASPNET 和 ASP.NET Core 应 用 程序 将 使 用 这 里 打包 的 类 库 。 


试 一 试 ”打包 .NET Standard 类 库 


使 用 Visual Studio 2017 和 msbuild 打包 上 一 个 练习 中 创建 的 .NET Standard 类 库 。 
(1) 打开 上 一 个 练习 创建 的 Ch18CardLibStandard 项 目 。 右 击 该 项 目 , 选择 Edit | Chl 8CardLibStandard.csproj. 
(2) 更 新 C# 项 目 文件 .csproj， 使 其 如 下 所 示 。 可 以 自由 修改 特性 值 ， 如 Authors. 


«Project Sdk="Microsoft .NET.Sdk"> 

<PropertyGroup> 
<TargetFramework>netstandard2.0</TargetFramework> 
«PackageId»Chl8CardLibStandardc/PackageId-» 
<PackageVersion>1.0.0</PackageVersion> 
<Authors>Benjamin Perkins</Authors> 
<Description>Beginning C# 7 .NET Standard CardLib</Description> 
<PackageRequireLicenseAcceptance>false</PackageRequireLicenseAcceptance> 
<PackageReleaseNotes> 

Beginning C£ 7 .NET Standard CardLib for completing the Chapter 18 exercises 

«/PackageReleaseNotes- 
«Copyright»Copyright 2017 (c). All rights reserved.</Copyright> 
<PackageTags>Beginning C£ 7, CardLib</PackageTags> 

</PropertyGroup> 


<PropertyGroup Condition="'S (Configuration) |$ (Platform) '=="Release|AnyCPU'"> 
<DocumentationFile> 
bin\Release\netstandard2.0\Ch18CardLibStandard. xml 
</DocumentationFile> 
</PropertyGroup> 
</Project> 


(3) fZ Shift +F6， 或 者 选择 Build | Build， 重 新 生成 项 目 。 生 成 操作 将 在 Release 模式 下 进行 ， 如 前 面 的 图 
18-10 所 示 。 

(4) 查看 Ch18CardLibStandard 下 的 bin\Release\netstandard2.0 目录 中 的 输出 , 确认 生成 项 目的 操作 成 功 生 成 
了 XML 和 DLL 文件 。 

(5) 打开 Windows H] “Ata” X$, at IF Developer Command Prompt for VS 2017 ( 单 击 任务 栏 的 窗口 
图 标 ， 然 后 搜索 “dev”)。 

(6) 通过 执行 下 面 的 命令 ， 将 目录 路 径 改 为 Ch18CardLibStandard 项 目的 位 置 : 

cd C:\BeginningCSharp7\Chapter18\Ch18CardLibStandard 

(7) 然后 执行 下 面 的 命令 来 生成 NuGet 包 ， 如 图 18-11 所 示 。 


msbuild Chl8CardLibStandard.csproj] /t:pack /p:Configuration=Release 
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(8) 当 此 命令 成 功 执行 后 ， 将 创建 一 个 名 为 Ch18CardLibStandard.BeginningCSharp7.1.0.0.nupkg 的 NuGet €, 
并 将 其 保存 到 Ch18CardLibStandard 项 目 目录 路 径 的 bin\Release 目录 中 。 

(9) 将 刚 创 建 的 .NET Standard Ch18CardLibStandard NuGet 包 复 制 到 C:\ProgramFiles(x86)\Microsoft 
SDKs\NuGetPackages 目录 中 。 此 目录 就 是 脐 机 存储 NuGet 包 的 位 置 。 

(10) 要 脱 机 查看 NuGet €, 右 击 Chl8CardLibStandard W H, 选择 Manage NuGet Packages, 然后 从 Package 
source 下 拉 列 表 中 选择 Microsoft Visual Studio Offline Packages， 如 图 18-12 所 示 。 


Browse Installed Updates NuGet Package Manager: Ch18CardClientCore 


P- (C |_| include prerelease Package source: Microsoft Visual Studio Offline Packages ~ $ 


V3 Ch18cardlibstandard 
è Ch18CardLibStandard by Benjamin Perkins 

Beginning C£ 7 .NET Standard CardLib 
Version: Latest stable 1.0.0 


|) Options 


Description 

Beginning C£ 7 .NET Standard CardLib 

Version: 1.0.0 

Ownerisl Benjamin Perkins 

Author(s]: Benjamin Perkins 

Date published: Tuesday, September 19, 2017 (89/19/2017) 
Tags: Beginning C£ 7, CardLib 


Dependencies 


No dependencies 


Each package is licensed to you by its owner. NuGet is not responsible for, nor does it grant any licenses to, third- 
party packages. 


|_| Do not show this again 


18-12 


示例 说 明 

NET Core 和 .NET Standard LEA f ZIER, M DNX 迁移 到 projectjson， 再 到 如 今 的 .csproj 格式 。 这 
些 项 目 格式 的 目的 古 在 编 详 和 生成 项 目 时 ， 能 够 识别 依赖 。 如 前 所 述 ， 优 化 后 的 程序 的 一 个 特征 是 程序 很 小 ， 
而 要 求 有 时 手动 识别 程序 的 依赖 有 助 于 实现 这 个 目标 。 回 局 一 下 ， 在 Ch18Ex01 中 ， 当 打开 .csproj 文件 时 ， 能 
看 到 对 Newtonsoft.Json 的 包 引 用 。 运 行程 序 所 需 的 每 个 包 依 赖 部 将 在 该 文件 中 指定 。 
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Microsoft Build Engine (MSBUILD) Visual Studio 的 生成 平台 。 它 对 程序 员 是 透明 的 ， 并 使 用 .csproj 文件 
的 内 容 来 生成 程序 集 或 可 执行 文件 。 当 在 Visual Studio 中 选择 Build 或 Rebuild 菜单 项 时 , MEAR MSBUILD. 
男 外 ， 在 项 目的 Properties 选项 卡 中 执行 Build 配置 时 ， 将 把 配置 作为 参数 发 送 给 msbuild 可 执行 文件 。 还 可 在 
Visual Studio 的 外 部 ， 使 用 msbuild 的 命令 行 版 本 来 编译 和 生成 项 目 。 


注意 : 

除了 手动 生成 NuGet 包 ， 还 可 在 每 次 编译 类 时 创建 一 个 包 。 右 击 Chl8CardLibStandard 项 目 ， 然 后 选择 
Properties. 在 Package 选项 卡 中 ， 有 一 个 名 为 Generate NuGet package on build 的 复 选 框 。 从 该 复 选 框 的 名 称 可 
以 看 出 ， 当 启用 该 复 选 框 时 ， 每 次 执行 生成 操作 时 将 创建 一 个 NuGet &. 

虽然 本 例 中 的 NuGet 包 部 署 在 本 地 ， 但 程序 员 可 将 NuGet 包 部 署 到 Nuget.org， 使 其 成 为 公开 的 或 私有 的 。 
NuGet 是 .NET 目前 的 和 未 来 的 包 管 理 器 ， 许 多 程序 员 和 公司 都 使 用 NuGet 来 公开 自己 的 项 目 。.NET Standard 
Ch18CardLibStandard 库 就 公开 托管 在 NuGet.org 上 。 在 Visual Studio 中 选择 Manage NuGet Packages 后 ， 或 在 
Package Manager Console 中 输入 以 下 命令 ， 任 何人 都 可 浏览 找到 Ch18CardLibStandard: 


Install-Package Chl8CardLibStandard 


然后 ， 就 可 将 该 包 安装 到 程序 中 。 


现在 就 已 经 创建 并 打包 了 一 个 .NET Standard 类 库 ， 是 时 候 使 用 它 了 。 接 下 来 将 介绍 如 何 使 用 .NET Standard 


类 库 。 


18.6 使 用 Visual Studio 生成 .NET Core 应 用 程序 


NET Core 是 一 个 路 平 台 的 开源 应 用 程序 框架 。 结 合 使 用 NET Core 与 .NET Standard 关 库 ,程序 员 只 需要 编 
写 BCL 一 次 ， 就 在 所 有 支持 的 垂直 模型 中 使 用 它 。NET Core 的 好 处 是 ， 它 提供 了 真正 的 跨 平台 支持 。 

在 下 面 的 “ 试 一 试 ” 中 ， 将 创建 一 个 Console App CNET Core) 来 使 用 上 一 节 创 建 的 .NET Standard 类 库 。 这 
个 .NET Core 控制 台 应 用 程序 将 负责 发 牌 。 


试 一 试 ” 创 建 一 个 .NET Core 控制 台 应 用 程序 


下 面 将 使 用 Visual Studio 2017 创建 一 个 Console App(.NET Core)， 它 将 使 用 .NET Standard 类 库 
Ch18CardLibStandard 中 的 类 和 方法 。 

(1) 在 Visual Studio 中 选择 File | New | Project...， 创 建 一 个 新 的 Console App (NET Core) 应 用 程序 。 在 New 
Project 对 话 框 中 ， 选 择 类 别 Visual C# | NET Core， 然 后 选择 Console App (NET Core) 模板 。 将 路 径 改 为 
C:\BeginningCSharp7\Chapter18, 1% Console App 命名 为 Chl8CardClientCore， 然 后 单 击 OK 按钮 。 

(2) 右 击 项 目 ,选择 Dependencies | Manage NuGet Packages。 如果 将 .NET Standard NuGet 包 保 存 到 C:\Program 
Files (x86)\Microsoft SDKs\NuGetPackages 目录 中 ， 如 前 所 述 (参见 图 18-12)， 那 么 该 包 将 是 脱 机 可 用 的 。 

(3) 选择 Ch18CardLibStandard NuGet 包 的 本 地 副本 或 公开 副本 。 要 选择 本 地 副本 ， 可 在 Package source 下 
拉 列 表 中 选择 Microsoft Visual Studio Offline Packages(# il A 18-12); 要 选择 公开 副本 ， 请 参考 步骤 (S)。 

(4) 要 安装 本 地 包 ， 可 从 脱 机 包 列 表 中 选择 Ch1 8CardLibStandard NuGet 包 ， 然 后 单 击 Install 按钮 。 

(5) 要 在 Package Manager Console 中 安装 公开 包 ( 由 Benjamin Perkins 编写 )， 可 选择 Tools | NuGet Package 
Manager | Package Manager Console 菜单 项 。 然 后 ， 执 行 下 面 的 命令 : 

Install-Package Ch18CardLibStandard 

(6) 打开 Program.cs 文件 并 更 新 代码 ， 使 其 如 下 所 示 : 

using System; 


using static System.Console; 
using Chl8CardLibStandard; 
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namespace Chl8CardClientCore 

{ 
class Program 
{ 

static void Main(string[] args) 

{ 
Player[] players = new Player[2]; 
Write("Enter the name of player #1: "); 
players[0] = new Player(ReadLine()); 
Write("Enter the name of player 42: "); 
players[1] = new Player (ReadLine()); 


Game newGame = new Game(); 
newGame .SetPlayers (players); 
newGame .DealHands (); 


WriteLine ($"{players[0].Name} received this hand: "); 
foreach (var card in players[0].PlayHand) 
{ 

WriteLine ($"{card.rank} of [card.suit]s"); 


} 


WriteLine ($"{players[1].Name} received this hand: "); 
foreach (var card in players[1].PlayHand) 
{ 
WriteLine ($"{card.rank} of [card.suit]s"); 
} 
WriteLine ("Press enter to exit."); 
ReadLine (); 


(7) 执行 这 个 .NET Core 应 用 程序 ， 按 照 要 求 输入 两 个 玩家 的 姓名 。 结 果 和 友 出 的 牌 如 图 18-13 所 示 。 


图 18-13 


示例 说 明 

当 呈 现 一 个 Console App (.NET Core) 项 目 时 ,将 创建 一 个 默认 的 Program.cs 文件 , 并 使 用 Console. WriteLine() 
a HFFA “Hello World”. BJF RAR. Ae, HEREOF, Program 类 文件 中 只 包含 using System 
指令 。 这 从 另 一 个 角度 说 明了 侧重 点 在 于 让 程序 集 尽 可 能 小 。 与 之 相对 ，Console App (NET Framework) Jil H HP 
默认 包含 多 得 多 的 模块 。 其 次 注意 ， 在 示例 代码 中 , 添加 了 using static 指令 。 使 用 此 指令 后 ,要 使 用 WriteLine() 
方法 ， 碌 不 需要 提供 对 Console 类 的 静态 引用 。 

默认 情况 下 ，Console App CNET Core) 项 目 面 同 的 是 .NET Core 2.0 框架 ， 这 是 计算 机 上 存在 的 .NET Core HE 
A Jape iy AS. NET Core 2.0 SDK 默认 情况 下 在 项 目 中 包含 许多 依赖 。 展开 项 目的 Dependencies 文件 夹 可 埋 看 
这 些 依赖 。 如 前 所 述 ， 当 编译 并 部 普 程 序 集 上 时， 程序 集 中 只 包含 必要 的 依赖 。 这 使 得 程序 集 占用 的 空间 尽 可 
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当 执行 代码 时 ， 将 实例 化 一 个 Player[] 类 数组 ， 该 数组 包含 两 个 元 素 ， 并 被 命名 为 players。 然 后 请 求 两 个 
玩家 的 姓名 ， 并 使 用 ReadLine0 方 法 从 控制 台 获 取 这 两 个 姓名 ， 存 储 到 player[0] 和 player[1] 元 素 中 。 实 例 化 一 
个 新 的 Game 类 ， 命 名 为 newGame， 然 后 调用 SetPlayers0 方 法 ， 并 传 入 players 数组 作为 参数 ， 从 而 同 Game 
分 配 玩家 。 调 用 Game 类 中 的 DealHands0 方 法 ， 并 为 每 个 玩家 使 用 foreach 语句 迭代 该 方法 的 结果 。 查 看 结果 

当 执 行 Console App (NET Core) 时 ， 可 注意 到 一 个 明显 区 别 : 它 运 行 在 dotnet.exe 进程 中 (参见 图 18-13). 
注意 ,控制 人 台 标 题 的 路 径 是 C:\ProgramFiles\dotnet\dotnet.exe。Console App (NET Framework) 应 用 程序 被 编 详 到 一 
个 .exe 文件 中 ， 并 在 目 己 的 进程 内 运行 ， 与 Console App (CNET Framework M HE AE], {Œ Visual Studio 中 
运行 Console App CNET Core) 时 ， 应 用 程序 将 被 编译 到 一 个 程序 集 或 .dll 文件 中 ， 并 由 dotnet.exe 进程 加 载 和 
执行 。 


注意 : 

将 Console App CNET Core) 编 译 成 .exe 文件 是 可 以 实现 的 ， 这 称 为 独立 部 署 。 在 独立 部 署 中 ，NET Core 4E 
架 也 将 包含 到 部 署 包 中 ， 所 以 相 比 依赖 于 框架 的 部 署 ， 这 种 部 署 包 要 大 得 多 。 对 于 依赖 于 框架 的 部 署 ， 将 运行 
程序 的 计算 机 上 必须 安装 必要 的 框架 。 


到 现在 为 止 的 讨论 集中 在 如 何 创建 新 的 NET Standard 类 库 和 .NET Core 应 用 程序 。 下 一 节 将 讨论 如 何 将 原 
本 面 回 完整 NET Framework 版 本 的 程序 改 为 耐 同 .NET Core， 使 其 能 路 平台 运行 。 


18.7 ”从 .NET Framework 移植 到 .NET Core 


了 解 到 .NET Core 的 所 有 优势 后 ， 你 可 能 会 思考 如 何 使 用 这 个 新 框架 。 如 果 现 有 茶 个 程序 是 用 完整 版 本 
的 .NET Framework 编写 的 ， 那 么 可 将 这 个 程序 的 代码 移植 到 .NET Core。 因 为 每 个 程序 都 有 独特 的 约束 和 上 下 
文 ， 所 以 本 节 只 讨论 一 些 基 本 的 移植 想法 和 过 程 。 很 多 情况 下 ， 对 于 庞大 的 复杂 程序 ， 有 必要 完成 更 多 分 析 、 
规划 、 代 码 开 友和 测试 工作 。 

Microsoft 创建 了 一 个 叫 作 API Portability Analyzer 的 工具 ， 它 可 以 分 析 程 序 及 其 程序 集 ， 然 后 生成 一 个 报 
告 ， 指 出 该 程序 中 使 用 的 但 目前 未 包含 在 .NET Core 框架 中 的 API。 可 从 以 下 网 址 下 载 该 工具 : 
https://github.com/Microsoft/dotnet-apiport/。 将 代码 移植 到 .NET Core 时 ， 可 使 用 这 个 报告 作为 起 点 。 


从 .NET Framework 移植 到 NETCore 时 ， 还 应 该 考虑 以 下 几 点 : 
e 识别 任何 第 三 方 依赖 
理解 哪些 功能 不 可 用 


* 
e 升级 当前 的 .NET Framework 目标 
e 为 程序 选择 面 同 的 平台 
187.1 ”识别 第 三 方 依赖 
如 前 所 述 , NET Core 框架 能 跨 平台 (Windows、 Linux. macOS), 在 多 个 芯片 组 (x64、x86、ARM) 上 运行 。 NET 
Core 程序 集 针对 这 些 目 标 平台 编 详 后 ， 就 能 在 这 些 平台 上 运行 和 工作 。 但 这 并 不 意味 看 项 目 中 包含 的 所 有 程序 
集 都 能 在 目标 平台 上 使 用 。 可 能 某 个 第 三 方 包 只 支持 运行 在 32 位 (x86) 处 理 器 模式 中 ,或 者 没有 在 Linux OS 上 
运行 的 包 。 对 于 这 种 情形 ， 开 有 友人 员 必 须 找到 一 种 蔡 代 方案 ， 或 者 联系 第 三 方 ， 询 问 他 们 是 否 有 计划 提供 此 类 
支持 。 


18.7.2 理解 哪些 功能 不 可 用 


如 果 第 三 方程 序 集 使 用 了 Windows OS 特有 的 技术 ， 如 AppDomains、 远 程 处 理 、 文 件 访问 等 ， 那 么 项 目 中 
3 含 的 第 三 方程 序 集 将 无 法 按 预期 方式 工作 。 下 面 这 个 网 址 详细 列 出 了 不 支持 的 API: https://github.com/dotnet/ 
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corefx/wiki/ApiCompat。 通 过 比较 这 个 列表 并 审查 .NET Framework 程序 中 包含 的 代码 ， 能 更 深刻 地 理解 移植 
到 .NET Core 的 可 行 性 和 需要 的 工作 量 ， 并 认识 到 跨 平台 运行 的 好 处 。 


187.3 ”升级 当前 的 .NET Framework 目标 


除 将 开发 IDE 升级 到 Visual Studio 2017 或 更 高 版 本 ， 计 划 移 植 到 .NET Core 的 个 人 或 团队 还 应 该 确定 .NET 
Framework 的 最 高 文 持 版 本 。 有 目前 ， 当 运行 在 NET Core 1.1 SDK 中 时 ，.NET Core 文 持 的 .NET Framework 最 局 
版 本 是 .NET Framework 4.6.2。 对 于 .NET Core 2.0， 支 持 的 最 局 版 本 是 4.6.1。 表 18-3 概述 了 支持 版 本 ， 要 查看 
完整 列表 ， 可 访问 https://docs.microsoft.com/en-us/dotnet/standard/net-standard. 

以 这 种 方式 升级 ,确保 对 于 之 前 的 .NET Framework 目标 ,程序 中 的 大 部 分 代码 有 支持 的 .NET Core API。 如 
果 由 于 某 种 原因 ， 原 程序 的 API 在 NET Core 项 目 中 不 存在 ， 那 么 有 以 下 几 种 选项 ; 

。 参考 前 一 节 “ 理 解 哪些 功能 不 可 用 ”。 

e 确认 ApiPort 报告 中 列 出 了 该 API。 

e 在 框架 中 添加 该 API 前 ， 保 持 使 用 当前 的 框架 版 本 。 回 顾 一 下 ， 表 18-2 说 明了 框架 一 直 在 添加 API. 

e 找 一 个 蔡 代 的 API、 第 三 方程 序 集 或 NuGet 包 来 帮助 解决 问题 并 满足 需求 。 


18.7.4 ”为 程序 选择 目标 平台 


NET Core 新 增 的 、 激 动人 心 的 特征 是 其 能 跨 平 台 运行 。 移 植 过 程 的 一 个 重要 方面 是 决定 面向 什么 平台 : 
Windows、Mac、Linux， 还 是 面向 全 部 3 种 平台 ? 你 应 该 认真 考虑 将 大 部 分 代码 放 到 .NET Standard 类 库 中 。 这 
样 能 为 开发 人 员 和 公司 提供 最 大 的 机 会 在 多 个 Windows 垂直 模型 上 同时 运行 这 些 代 码 ， 并 跨 平 台 执行 。 

总之 ，.NET Standard 是 一 个 类 库 ， 文 持 编 写 在 多 个 垂直 模型 中 运行 的 BCL。.NET Core 束 是 这 样 的 一 个 垂 
直 模 型 ， 它 是 路 平台 的 、 开 源 的 。 通 过 使 用 NuGet 包 ，.NET Core 的 模块 化 设计 帮助 减 小 了 占用 的 空间 ， 并 为 
在 云 平 台 上 运行 做 进一步 优化 。 开 始 创建 新 项 目的 开 及 人 员 应 该 认真 考虑 将 此 垂直 模型 作为 未 来 的 编程 方 问 ， 
因为 它 可 运行 在 多 个 垂直 横 型 中 和 多 个 平台 上 。 


18.8 FRSA 


rz 题 要 A 
关键 的 跨 平 台 术 语 表 18-1 列 出 了 你 应 该 了 解 的 重要 里 平台 术语 
NET Standard API NET Framework 名 称 空间 中 的 一 组 类 和 方法 ， 供 跨 平 台 或 跨 垂 直 模 型 的 程序 使 用 
标 目标 版 本 越 高 ， 支 持 的 平台 越 少 ， 但 API 的 数量 越 多 ， 这 是 一 个 取舍 问题 
NET Core —T EPP GH. JFUSEJSE BLEU 
开源 由 开发 人 员 组 成 的 开放 社区 编写 并 支持 的 代码 或 框架 


NuGet 包 一 种 安装 程序 依赖 的 模块 化 方法 。 不 创建 对 程序 集 的 引用 ， 而 是 安装 程序 集 NuGet 


SB ie 


ASP.NET 5 ASP.NET Core 


REAR: 
e Web 应 用 程序 概述 
e 选择 各 种 ASPNET 风格 的 原因 
e 使 用 ASPNET Web Forms 
e 创建 ASPNET Core Web 应 用 程序 

本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter19 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 
Moo E. 


Windows Presentation Foundation(WPF) A H.Bij Ey Windows Forms 用 来 编写 在 Windows 操作 系统 上 运行 的 应 
用 程序 ，Universal Windows App(UWA) 应 用 程序 类 型 则 用 来 编写 针对 平板 电脑 和 其 他 移动 设备 ， 并 可 从 Microsoft 
Store 下 载 的 应 用 程序 。 与 这 些 技术 不 同 ， 开 有 人员 使 用 ASPNET 来 创建 Web 应 用 程序 ， 这些 Web 应 用 程序 托 
^51 fE Internet 或 Intranet 的 Web 服务 器 上 ， 主 要 被 mtermet 浏 宽 器 通过 HTTP 协议 使 用 。 

ASPNET 技术 为 程序 员 提 供 了 一 个 库 和 框架 ， 使 他 们 能 够 以 类 似 于 编写 WPF 和 UWA 应 用 程序 的 方式 来 
编写 Web 应 用 程序 。 关 键 区 别 在 于 ，ASPNET 控件 不 是 在 计算 机 上 的 可 执行 文件 中 运行 的 控件 ， 如 Textbox 和 
Button, MÆR imiz. JF HTML 抽象 。HIML 代码 在 Internet N ge PEM S Windows 控件 的 行为 。 
WPF/UWA 应 用 程序 与 Web 应 用 程序 之 间 还 有 其 他 许多 区 别 , 主要 与 基于 Web 的 搬 层 技术 有 关 , 如 HTTP、 IS, 
HTML 和 JavaScript, AB VES LB. 

本 章 概述 如 何 使 用 ASPNET Web Forms 和 ASP.NET Core 来 编写 Web 应 用 程序 。 另 外 ， 因 为 ASPNET 有 
多 种 风格 (如 MVC. Web Forms. Web Pages 和 Web APD， 本 章 还 将 说 明 它 们 的 区 别 和 每 种 风格 的 使 用 场景 。 另 
外 将 介绍 并 详细 分 机 ASP.NET Web Site 和 ASPNET Web Application Projects 的 区 别 。 


te: 
本 章 的 “ 试 一 试 ”练习 以 第 18 章 创 建 的 Ch18CardLibStandard NET Standard 类 库 为 基础 。 在 做 本 章 的 练习 
之 前 ， 一 定 要 先 阅读 第 18 章 ， 并 完成 第 18 章 的 示例 。 
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除了 比较 ASPNET 的 各 种 风格 及 项 目 类 型 ， 本 章 还 讨论 了 Web 控件、 输入 验证 、 状 态 管理 和 身份 验证 等 
主题 。 下 面 首先 介绍 Web 应 用 程序 是 什么 ， 有 什么 优点 ， 以 及 有 具有 什么 独特 属性 和 特征 。 


19.1 Web 应 用 程序 概述 


Web 应 用 程序 使 Web Hk S 23 [n] 2 P3 IH. HTML 和 /或 JavaScript fid. ee ISTE Web 浏览 
器 (如 Microsoft Edge. Chrome BV Firefox) Pita. SHP EÙ EASA Web 地 址 (URL)， 并 按 下 Enter 
键 以 后 ， 就 会 向 Web 服务 器 发 送 一 个 HTTP ick. HTTP 请 求 可 包含 文件 名 ， 如 Defaultaspx， 以 及 其 他 一 些 信 
W, W cookie、 客 忆 山 文 持 的 语言 、 安 全 令 牌 以 及 与 该 请 求 有 关 的 其 他 数据 。 然 后 ，Web 服务 器 返回 一 个 包含 
HTML 代码 的 HTTP 啊 应 。Web 浏览 器 将 解释 这 些 HTML 代码 ， 并 将 文本 框 、 按 钮 或 列表 等 显示 给 用 户 。 如 
R HTTP 啊 应 中 包含 JavaScript, WAX JavaScript 代码 将 在 客户 靖 加 载 页 面 时 运行 ， 或 者 在 发 送 进一步 的 
HTTP 请 求 之 前 进行 一 些 验证 。 例 如 ，JavaScript 代码 可 能 确认 在 单 击 Submit 按钮 时 ， 茶 个 文本 框 中 有 值 。 当 
后 面 编写 ASPNET Web Form (ASPX) 和 ASPNET Core 应 用 程序 的 时 候 ， 注 意 ASPNET 的 page 对 象 及 其 属性 。 
事实 上 ，Request 和 Response 就 是 page 对 象 的 两 个 属性 。 

使 用 ASPNET 技术 ， 可 通过 服务 器 端 代码 动态 创建 Web 页 面 。 这 些 Web 页 面 的 开发 方法 能 做 到 与 客户 端 
Windows 程序 类 似 。 使 用 ASPNET 时 ， 不 必 直 接 处 理 HTTP 请 求 和 响应 ， 并 手动 创建 HTML 代码 来 发 送 给 客 
户 端 ， 而 是 使 用 ASPNET 控件 ， 如 TextBox, Label. ComboBox 和 Calendar， 它 们 会 创建 HTML 代码 。 要 创建 
一 个 服务 器 端的 TextBox 控件 ， 可 在 ASPNET Web Form (ASPX) 文 件 中 添加 下 面 的 代码 : 

<asp: TextBox ID-"playerlTextBox" runat="server" /> 

要 使 用 Razor 语法 (第 16 草 介 绍 过 ) 实 现 相 同 的 功能 ， 可 使 用 下 面 的 语法 : 

@Html.TextBox ("playerlTextBox") 

在 每 种 情况 下 ， 当 对 包含 这 些 代 码 段 的 文件 发 出 HTTP 请 求 时 ， 将 执行 这 些 代 码 ， 并 向 客户 端 返 给 HTTP 
啊 应 ， 其 中 包含 该 控件 的 HTML 表示 。 图 19-1 说 明了 请 求 如 何 从 浏览 器 发 送 给 IIS 服务 器 ， 又 如 何 从 IIS 服务 
ss VLE] Ary EAE o 


IS 


图 19-1 


19.2 ”选择 合适 的 ASP.NET 


当 解 决 方 采 架 构 师 或 程序 员 认 定 运 行 目 己 程序 的 最 好 平台 是 网 站 后 ， 下 一 步 是 决定 使 用 哪 种 风格 的 
ASPNET. Microsoft 的 第 一 代 Web 开发 平台 是 Active Server Pages, HER ASP. ASP 在 .asp 文件 中 使 用 与 Razor 
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类 似 的 语法 ， 且 常 包含 一 个 嵌入 的 VB COM, 该 VB COM 是 使 用 Service.CreateObject0 初 始 化 的 ， 以 便 能 引用 
API 中 公开 的 方法 。 虽 然 仍然 支持 ASP 这 种 技术 ， 但 在 创建 新 的 基于 Web 的 程序 时 ， 不 建议 使 用 这 种 应 用 程 

在 21 世纪 初创 建 出 NET Framework 时 ,ASP 需要 进行 更 新 , 目 然 会 利用 该 框架 ,结果 被 重合 名 为 ASPNET。 
二 者 主要 的 区 别 在 于 ，ASPNET 将 表示 层 (.aspx 文件 ) 与 业务 罗 辑 层 (aspx.cs 或 aspx.vb WIIF. WARE 
常 被 称 为 代码 隐藏 。 代 码 隐藏 支持 的 语言 包括 C# 和 VBNET，ASPNET 模型 则 被 称 为 Web Forms。 在 创建 面向 
IIS 和 Windows Server 操作 系统 的 功能 友好 、 凯 度 复杂 的 应 用 程序 时 ，ASPNET Web Forms 仍然 是 有 效 的 、 得 
到 完全 支持 的 技术 。 经 过 多 年 的 设计 和 功能 改进 ，ASPNET Web Forms 显然 变 得 有 些 腔 肿 。 稍 后 将 介绍 “ 爱 肿 ” 
的 有 具体 含义 , 现在 只 需要 知道 , 这 种 “ 脐 肿 ”标签 促使 Microsoft 开发 一 种 新 风格 的 ASPNET, 即 ASPNET MVC. 

ASP.NET MVC 中 的 MVC 代表 Model-View-Controller( 模 型 -视图 -控制 器 )。 如 前 所 述 ，ASPNET Web Forms 
将 ASP 代码 分 为 两 个 不 同 的 层 : 表示 层 和 业务 逻辑 层 。MVC 还 分 出 了 第 三 个 层 ， 这 三 个 层 分 别 是 : 

e 模型 一 一 业务 层 

e 视图 一 一 表示 层 

e 控制 占 一 一 输入 控制 层 

ASP.NET MVC 是 ASPNET Web Forms fe 42 (Ni FATA, (BEYER, ASP.NET MVC 的 设计 、 文 持 概 
念 和 实践 发 生 了 明显 变化 。 一 些 具 有 ASPNET Web Forms 背景 的 程序 员 可 能 一 开始 觉得 这 些 变化 很 有 挑战 性 ， 
但 当 认 真 使 用 这 个 模型 后 , 将 能 清晰 理解 其 概念 。 稍 后 详细 讨论 每 种 ASPNET 风格 时 , 还 将 继续 介绍 相关 内 容 。 


注意 : 

每 种 主要 的 ASP.NET 风格 (Web Forms f» MVC), 以 及 ASP 和 ASPNET Web API, 由 所 谓 的 处 理 程序 处 理 。 
处 理 程序 通常 是 在 IIS 内 配置 的 一 个 .dll 程序 集 。 该 程序 集 解 析 文 件 ， 执 行文 件 中 的 代码 ， 然 后 将 HTML 返回 
给 发 出 请 求 的 客户 端 。 


ASPNET Core 是 ASPNET 大 家 庭 中 的 新 成 员 ， 它 与 NET Core 的 关系 就 像 ASPNET 与 NET Framework 的 
关系 。 与 .NET Core 一 样 ，ASPNET Core 是 一 个 开源 框架 和 平台 ， 可 和 面 同 Microsoft Windows 以 外 的 操作 系统 ， 
如 Linux 和 macOS。ASPNET Core x: f$ Web Applications 和 Web Applications (Model-View-Controller) 项 目 类 型 。 
ASPNET Core Web Applications 与 ASPNET Web Pages 风格 类 似 ， 为 小 型 网 站 的 程序 员 提供 了 一 个 比较 简单 的 
实现 ， 而 ASPNET Core Web Applications (MVC) 为 路 平台 运行 Web 应 用 程序 提供 了 完整 的 MVC 功能 。 


注意 : 

关于 ASP.NET Web API 的 完整 细节 ， 请 参阅 第 17 章 。 

总 之 ，ASPNET Web API 就 像 是 一 个 公开 了 API 的 .dll。 没 有 表示 层 ， 只 能 调用 公开 的 API 方法 ， 并 传 入 
必要 的 参数 。API 方法 调用 的 结果 是 一 个 数据 字符 串 ， 在 ASPNET Web API 中 ， 这 个 字符 串 采 用 ISON 格式 。 
之 后 ,发 出 调用 的 客户 端 需要 解析 并 以 可 用 形式 呈现 JSON 数据 。 至 此 你 了 解 到 Microsoft Web 应 用 程序 框架 的 
发 展 和 演化 历史 ， 接 下 来 将 介绍 如 何在 这 些 框架 中 做 出 选择 。 


19.2.1 ASP.NET Web Forms 


选择 ASPNET Web Forms 而 不 是 其 他 框架 的 原因 是 : 

e 对 于 中 小 型 开发 团队 和 开发 项 目 而 言 ，Web Forms 是 最 理想 的 选择 

e 对 于 需要 在 HTTP 通信 中 维护 会 话 和 状态 的 Web 应 用 程序 而 言 ，Web Forms 很 有 用 

e Web Forms 基于 非 营 直观 的 一 组 请 求 管道 事件 

相对 于 其 他 ASPNET 风格 ，ASPNET Web Forms 是 快速 开发 和 部 署 功能 丰富、 性 能 良好 的 Web 应 用 程序 
的 最 好 、 最 简单 的 方法 。 表 示 逻 辑 和 业务 逻辑 分 离开 来 ， 与 前 咒 用 户 界 面 开 发 人 员 和 后 台 编 码 人 员 的 技能 集 很 
好 地 对 应 起 来 。 这 是 一 种 理想 情况 ， 因 为 团队 可 让 具备 不 同 拉 能 的 人 员 同 时 开发 项 目的 不 同方 和 面 。 
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ASP.NET Web Forms $J Æ “RETIN”, REEF viewstate 功能 。viewstate 是 在 ASPNET Web Form 
中 维护 状态 的 一 种 方式 。 例如， 假设 一 个 Web 应 用 程序 需要 完成 并 提交 一 系列 页 面 才 能 下 订单 。 如 果 用 户 在 整 
个 过 程 中 的 某 一 步 单 击 了 返回 按钮 ， 将 使 用 原来 输入 的 值 重新 填充 之 前 的 表单 ， 这 就 是 通过 viewstate 实现 的 。 
viewstate 功能 的 问题 是 可 能 航 泪 用 (过 度 使 用 )， 导 致 在 客户 靖 和 服务 器 之 间 来 回 传递 非常 大 的 页 面 。 必 外 ， 默 
认 情 况 下 ，viewstate 是 针对 Page 局 用 的 ， 而 非 只 针对 需要 维护 状态 的 Web 页 面 控件 局 用 。 

为 避免 viewstate 市 来 的 问题 , 最 好 在 Page 级 别 禁 用 它 , 这 只 需要 将 EnableViewState 属性 设 为 false. 例如 ， 
如 果 之 后 需要 维护 TextBox 的 状态 , 可 使 用 下 面 的 代码 来 专门 针对 TextBox 局 用 viewstates 另外 , 需要 监控 .aspx 
文件 的 大 小 ， 确 保 它 们 不 会 变 得 太 大 。 

<asp:TextBox EnableViewState-"true" ID="Name" runat="server" /> 

没有 会 话 ， 束 无 法 维护 状态 。 维 护 会 话 这 个 概念 源 于 客户 凯 / 服 务 器 计算 时 代 ， 在 当时 ， 计 算 机 与 服务 器 之 
间 的 连接 是 永久 保持 的 。HTITP 协议 是 没有 状态 的 ， 特 别 适合 处 理 静 态 ( 即 非 动态 ) 的 内 容 。 

注意 : 

会 话 被 限制 到 工作 进程 (参见 图 19-1)， 这 意味 着 会 话 中 存储 的 值 不 能 被 其 他 会 话 访问 。 当 ASP.NET 应 用 程 
序 需 要 在 云 中 或 Web 场 中 运行 时 ， 这 是 一 个 非常 重要 的 约束 。 


ASP.NET Web Forms 之 所 以 是 动态 的 , 是 因为 代码 隐藏 文件 (如 Default.aspx.cs) 中 使 用 的 C# 代 码 ， 当 请 求 该 
文件 时 , 其 中 的 代码 就 会 执行 。 返 回 给 浏览 器 的 HTML 很 可 能 是 C# 代 码 基 于 客户 端 /用 户 的 独特 输入 来 改变 的 。 
根据 会 话 cookie 中 存储 的 内 容 ， 返 回 的 HTML 对 于 每 个 客户 端 也 可 能 是 不 同 的 。ASPNET Web Forms 程序 员 
使 用 以 下 语法 在 会 话 中 存储 信息 : 

Session["username"] = TextBoxUID.Text; 

在 后 续 HTTP 请 求 中 ， 可 使 用 以 下 代码 来 访问 名 为 username 的 会 话 变量 : 

var username = Session["username"];:; 

最 后 ， 在 执行 ASPNET Web Forms 请 求 时 会 友 生 一 些 事件 ， 如 BeginRequest. AuthenticateRequest. Init, 
Load, ProcessRequest 和 EndRequest 等 ， 它 们 的 含义 不 言 自 明 。 这 一 点 很 重要 ， 因 为 当 程 序 员 想 采取 一 些 特 殊 
操作 来 验证 客户 应 的 身份 ， 或 在 完成 请 求 之 前 清理 数据 时 ， 很 容易 判断 在 什么 地 方 添 加 相关 代码 。 


19.22 ASP.NET MVC 


选择 ASPNETMVC， 而 不 是 其 他 ASP.NET 应 用 程序 类 型 的 原因 如 下 : 

e ASP.NET MVC 非常 适合 较 大 的 、 较 复杂 的 Web 应 用 程序 

e ASP.NET MVC 5 Entity Framework (EF) 和 模型 绑 定 崇 密 结合 在 一 起 

e ASP.NET MVC 与 测试 驱动 开发 (Test-Driven Development, TDD) X22 454 EE 

如 前 所 述 ，ASPNET Web Forms 分 为 两 个 单独 的 模块 ，ASPNET MVC 则 分 为 三 个 单独 的 模块 : 模型 、 视 
图 和 控制 器 (如 图 19-2 所 示 )。 前 面 提 到 了 分 离 模块 对 ASP.NET Web Forms 的 帮助 ， 对 于 ASPNET MVC， 模 块 
的 分 离 也 有 同样 的 帮助 。 模 块 的 分 离 ， 使 得 较 大 的 团队 能 按 专长 分 组 ， 同 时 开发 应 用 程序 的 不 同方 面 ， 从 而 加 
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模型 


yag 
EEA 


控制 器 "E 


it) 


Entity Framework(EF) 是 一 种 对 象 关 系 杭 型 (Object Relationship Model，ORM) 技 术 ， 将 在 第 23 章 介 绍 。 它 与 
ASP.NET MVC 架构 和 模型 绑 定 紧密 结合 在 一 起 -ORM( 以 及 EF) 使 开发 人 员 能 以 面向 对 象 的 方式 设计 数据 库 。 
Han, WREN ASP.NET MVC 应 用 程序 用 于 存储 关于 人 的 信息 ， 那 么 下 面 的 Person 类 可 存储 和 检索 这 些 

poe 


public class Person 

{ 
public string Name { get; set; } 
public int Age { get; set; } 

} 


设计 好 数据 模型 后 ， 开 发 人 员 可 将 模型 部 署 到 数据 库 ( 如 SQL Server) 和 数据 结构 。 数 据 库 表 及 主键 和 
外 键 是 使 用 C# 类 中 的 描述 生成 的 。 当 在 Visual Studio 中 创建 一 个 ASP.NET MVC 应 用 程序 后 ， 默 认 解决 方 
案 会 包含 一 个 Models XR, HERI C# 类 表示 就 放 在 这 个 文件 夹 中 。 这 些 类 用 于 存储 内 存 中 的 数据 
库 数据 , 供 更 新 视图 的 控制 器 修改 。 在 默认 的 ASPNET MVC 应 用 程序 中 , 有 一 个 名 为 Controllers 和 Views 
的 文件 夹 。 

在 控制 器 中 ， 开 发 人 员 添 加 代码 ， 通 过 使 用 绑 定 的 Model 对 象 (如 Person) 和 EF 逻辑 来 创建 、 读 取 、 
更 新 或 删除 数据 库 的 内 容 。 控 制 器 也 是 执行 任何 业务 逻辑 、 身 份 验证 或 应 用 程序 需要 的 其 他 任何 活动 的 
地 方 。 视 图 是 表示 层 ， 由 客户 端 触 发， 在 控制 器 中 使 用 面 问 对 象 模型 执行 的 动作 的 输出 将 在 这 里 呈现 给 
客户 站。 

ASPNET MVC 与 测试 驱动 开发 技术 紧密 结合 在 一 起 , 与 ASPNET Web Forms HH, 更 容易 进行 单元 测试 。 
如 图 19-3 所 示 ， 当 创建 一 个 ASPNET 应 用 程序 时 ， 有 一 个 复 选 框 可 供 选 择 ， 如 果 选 中 该 复 选 框 ， 将 创建 另 一 
个 项 目 ， 专 门 用 于 对 此 程序 进行 单元 测试 。 
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A project template for creating ASP.NET MVC 
applications. ASP.NET MVC allows you to build 

T T m E applications using the Model-View-Controller 

e 全 一 s} ae architecture. ASP.NET MVC includes many features that 

Empty Web Forms Web API Single Page enable fast, test-driven development for creating 

Application applications that use the latest standards. 
ti 
m 


Azure API App 


Learn more 


Authentication: No Authentication 


Add folders and core references for: 


LI Web forms Y mvc | web API 


"i Add unit tests 


Test project name: ASP.NET-MVC-TDD. Tests 


E] 19-3 


通过 将 测试 代 人 码 放 到 Tests 项 目 中 ， 可 从 测试 用 例 抽象 出 依赖 ， 如 IIS. BRAD AB. Ke T E 
要 且 有 和 儿 助 的 功能 ， 因 为 在 不 同 的 生产 实例 中 ， 数 据 肖 当 是 不同 的 ， 而 且 运 行 HS 的 服务 器 版 本 可 能 在 生产 环 
境 和 测试 环境 中 表现 出 不 一 致 的 行为 。 移 除 这 些 依赖 ， 即 只 测试 控制 右 内 的 逻辑 ， 而 不 考虑 依赖 的 状态 ， 能 改 
进 测试 的 速度 和 效率 。 原 因 在 于 ， 开发 人 员 不 必 使 所 有 依赖 你 持 在 有 效 的、 稳定 的 测试 状态 (这 是 非 第 耗 时 的 操 
作 )， 而 可 以 将 注意 力 集中 在 确 你 测试 场景 能 成 功 完成 。 


注意 : 
依赖 发 生变 化 是 很 常见 的 情形 ; 但是， 这些 变化 会 被 编写 到 测试 场景 中 。 关 键 在 于 ， 使 用 TDD É, Wik 
免 了 投入 精力 处 理 不 一 致 的 数据 或 平台 问题 . 


ASP.NET MVC 使 用 无 扩展 名 的 URL: 在 请 求 中 ， 不 会 添加 有 具体 文件 名 。 在 ASPNET Web Forms 应 用 程序 
中 会 请 求 .aspx 文件 , 但 在 ASPNET MVC 中 并 非 如 此 。ASPNET MVC 采用 了 “路 由 ”概念 ， 使 用 URL 片段 (而 
不 是 文件 名 ) 把 请 求 路 由 到 正确 的 控制 器 和 视图 。 例 如 ， 请 求 /Home/About 时 ， 将 执行 名 为 HomeController 的 控 
制 器 中 的 About0 方 法 ， 该 控制 器 保存 在 Controllers 文件 夹 中 。 通 过 使 用 Views\Home 目录 中 名 为 Aboutcshtml 
的 视图 ， 将 About0 方 法 的 结果 呈现 给 客户 端 。 
19.2.3 ASP.NET Web API 

选择 ASPNET Web API 的 原因 与 选择 ASPNET MVC 应 用 程序 类 型 类 似 : 这 种 应 用 程序 类 型 与 EF 以 及 TDD 
概念 紧密 结合 在 一 起 ,非常 适用 于 较 复 杂 的 大 型 Web 应 用 程序 。 主 要 区 别 在 于 , ASPNET Web API Visual Studio 
项 目 中 没有 View 组 件 或 Views 文件 夹 。 根 据 第 17 章 介绍 的 API 概念 ， 这 是 很 合理 的 ， 因 为 客户 端 会 调用 API 
公开 的 方法 ， 然 后 该 方法 返回 一 些 数据 。 客 户 端 负责 使 用 API， 对 API 的 操作 做 出 啊 应 ， 和 /或 呈现 API 的 结果 
(通常 是 JSON 格式 )。 


1924 ASPNET Core 


第 18 章 讨 论 了 NET Core 和 .NET Standard 的 优点 。 ASPNET Core 应 用 程序 类 型 中 同样 存在 NET Core 的 优 
点 。 下 面 列 出 一 些 优点 : 


ASP.NET Core 能 跨 平 台 运 行 。 
ASP.NET Core 不 依赖 于 IS. 

ASP.NET Core 不 依赖 于 完整 的 .NET Framework. 
ASP.NET Core 针对 云 做 了 优化 ， 并 且 性 能 更 好 。 
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Ej. NET Core 类 似 ，ASPNET Core 能 在 Microsoft Windows 以 外 的 操作 系统 (如 macos 和 Linux) 上 运行 。 过 
去 提 到 任何 ASPNET 应 用 程 厅 类 型 了 时， 它们 无 疑 天 联 厦 Internet Information Services(IIS). ASP.NET Core 包含 
一 个 新 的 Web 服务 器 ， 叫 作 Kestrel, 19.4 节 “ 创 建 ASPNET Core Web 应 用 程序 ”将 详细 介绍 。ASPNET Core 
可 将 OS 作为 反 同 代理 服务 器 ， 运 行 在 HIS 上， 也 可 在 一 个 只 运行 Kestrel 的 独立 容器 内 运行 。 

ASPNET Core 不 需要 、 也 不 依赖 于 完整 的 NET Framework 库 。 相 反 ， 与 NET Core 一 样 ， 应 用 程序 部 署 包 
中 只 包含 执行 程序 功能 所 需 的 程序 集 。 模 块 化 的 、 性 能 极 佳 的 独立 应 用 程序 包 将 被 部 普 到 服务 器 或 云 平台 ， 供 


执行 和 使 用 。 


由 于 Kestrel 对 ASPNET Core 的 大 小 和 代码 执行 路 径 做 了 优化 ， 所 以 相 比 ASP.NET 4.6 Web Forms, 每 秒 处 
理 的 请 求 数 (Requests Per Second，RPS) 提 升 了 5.5 fii. FALE Nodejs，ASPNET Core 在 Kestrel 的 运行 性 能 提升 
了 3 倍 ， 如 表 19-1 所 示 。 


ASPNET Web Forms 4.6 ~57 000 
ASP.NET Core 在 Kestrel 上 运行 时 ~310 000 
Node.js ~105 000 


表 19-1 基准 性 能 比较 


每 秒 处 理 的 请 求 数 (RPS) 


RPS 性 能 测试 是 在 相同 的 操作 系统 (Windows Server 2012 R2) 上 执行 的 ， JF RAM 大 小 、CPU 速度 /类 型 和 
网 络 接口 卡 都 是 相同 的 。 因 此 ， 性 能 差异 完全 源 于 应 用 程序 类 型 中 的 优化 和 执行 效率 。 


19.2.5 ASPNET Web Site 与 ASPNET Web Application Project 类 型 的 对 比 


如 图 19-4 所 示 ， 新 的 ASPNET Web 应 用 程序 分 为 两 种 类 型 : Project 和 Web Site. 


1] Start Page - Microsoft Visual Studio 

File | Edit View Project Debug Team Tools 
New + 
Open 

@ Start Page 


Close 


€ Save All 


Ctrl+Shiit+S 


Source Control , 


Account Settings... 
Recent Files 


Recent Projects and Solutions 


Exit Alt+F4 


R 19-2 显示 了 这 两 种 类 型 的 区 别 。 


Project From Existing Code... 


Help 
Ctrl - Shift - N 
Shift - Alt--N 
Ctrl+N 
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表 19-2 Project 和 Web Site 的 区 别 


文件 结构 C# 项 目 有 一 个 .csproj 文件 ， 其 中 包含 运行 程序 所 需 | 对 于 使 用 C# 创 建 的 Web Site， 没 有 .csproj 文件 。 
的 文件 和 程序 集 引 用 的 列表 目录 结构 中 的 所 有 文件 都 包含 在 网 站 中 
编译 代码 隐藏 文件 编译 成 为 一 个 程序 集 (-dID 源 代码 在 被 第 一 次 请 求 时 动态 编译 。 这 通常 会 生 
成 多 个 程序 集 (.dll) 
部 署 程序 集 (.dID、.aspx 和 .ascx 文件 被 部 署 到 将 使 用 该 应 | 将 Web 应 用 程序 源 代码 的 一 个 副本 部 署 到 Web 
用 程序 的 Web 服务 器 上 服务 器 上 (包括 .aspx、.ascx 和 aspx.cs) 
1. 文件 结构 


ASPNET Projects 的 .csproj( 项 目 文件 ) 允 许 从 项 目 中 移 除 不 会 包 合 在 部 普 中 ， 但 也 不 会 被 水 人 移 除 的 文件 。 
文件 将 从 项 目 中 排除 出 去 ， 但 不 会 被 删除 。 如 果 需 要 进行 部 普 ， 但 是 有 一 些 文件 还 没有 准备 好 ， 那 么 这 种 能 力 
很 有 帮助 。 另 外 ， 上 一 章 讲 到 ， 项 目 文件 用 于 存储 关于 NET Standard 类 的 信息 ， 这 些 信 息 用 于 创建 NuGet 包 。 
在 Web Site 中 ， 没 有 .csproj 文件 ， 所 以 网 站 目录 结构 中 的 所 有 文件 都 被 视 为 解决 方案 的 一 部 分 。 

2. 编 去 

ERE H cintu Web Application Project， 怠 不 必 在 部 四 后 第 一 次 请 求 .aspx 文件 时 编译 该 文件 及 其 代码 隐 
闫 文件， 从 而 节省 一 些 时 间 。 虽 然 使 用 NGEN 也 可 以 预 编 译 Web Site， 但 相 比 简单 地 手动 发 出 第 一 个 请 求 让 
ASPNET 运行 库 编 详 ASPNET 文件 ， 这 种 预 部 署 活动 要 复杂 得 多 。 

将 编译 后 的 程序 集 或 ASPNET Project 加 载 到 内 存 时 , 整个 Web 应 用 程序 会 占用 内 存 。 另 一 方面 , 对 于 Web 
Site， 只 有 请 求 到 的 文件 会 被 编译 并 加 载 到 内 存 中 。 因 此 ， 如 果 项 目 中 只 使 用 少量 页 面 ， 那 么 这 样 的 项 目 会 比 
Web Site 使 用 更 多 的 内 存 ， 因 为 如 前 所 述 ， 在 Web Site 中 ， 只 有 请 求 的 文件 会 被 编译 并 加 载 到 内 存 中 。 当 客户 
在 云 平 台 上 根据 使 用 的 资源 付费 时 ， 这 是 一 个 需要 考虑 的 重要 概念 。 

3. 部 署 

Wb Web Site I, 代码 隐藏 文件 (.aspx.cs) 中 的 源 代码 将 以 纯 文本 形式 部 闭 , 可 供 人 们 阅读 。 只 要 将 Web Site 


部 署 到 一 个 安全 位 置 ， 这 不 是 问题 ， 但 一 些 开发 人 员 或 公司 仍然 不 想 看 到 这 种 情况 。 使 用 项 目 时 ， 不 会 把 人 类 
可 读 的 代码 部 署 到 服务 器 上 ， 代 码 都 被 编译 到 程序 集 LdID 中 。 


警告 : 
虽然 程序 集中 的 代码 是 人 们 不 能 直接 阅读 的 ， 但 是 如 果 有 人 获取 到 对 服务 器 的 访问 权限 ， 就 可 以 捕捉 并 反 
编译 .dll 中 的 代码 。 一 定 要 严格 限制 对 运行 程序 的 服务 器 的 访问 。 


另外 , 把 ASP.NET Web Application Project 的 编译 后 的 程序 集 (.d 巾 加载 到 ASPNET Runtime 后 ， 如 要 修改 项 
目 ， 就 必须 停止 .ASPNET Runtime 进程 并 从 内 存 中 伙 载 ， 此 后 ， 修 改 的 内 容 才 对 使 用 该 网 站 的 客户 疹 生 效 。 如 
果 该 进程 有 程序 集 的 一 个 句柄 ， 吏 不 能 修改 项 目 ， 必 须 先 停止 进程 来 释放 句柄 。 对 于 Web Site， 则 并 非 如 此 。 
在 Web Site 中 ， 不 必 停 止 ASPNET 运行 库 ， 就 可 以 更 新 .aspx.cs 或 .aspx 文件 ， 当 下 一 次 请 求 这 些 文件 时 ， 就 会 
编译 它们 ， 并 把 它们 加 载 到 内 存 中 。 

现在 ， 你 已 经 了 解 到 各 种 ASPNET Web 应 用 程序 风格 之 间 的 区 别 ， 以 及 Projects 和 Web Sites Z HINES 
区 别 。 接 下 来 将 深入 分 析 ASPNET Web Forms 和 ASP.NET Core. 


19.3 使 用 ASP.NET Web Forms 


本 节 将 详细 讨论 一 些 重要 的 ASPNET Web Forms 概念 。 每 种 ASPNET 应 用 程序 风格 都 有 一 些 方面 使 自己 
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BRAEG f B). Bgise4dk n8. PORES PIT] ASP.NET Web Forms 特征 有 很 好 的 认识 : 
服务 器 控件 

输入 验证 

状态 管理 

身份 验证 和 授权 


— 
本 节 的 剩余 部 分 将 详细 介绍 这 4 点, 但 是 ASP.NET Web Forms 不 只 具有 这 几 个 方面 。 要 记 住 ， 本 书 不 是 专 
门 介绍 ASP.NET 的 ， 如 果 你 想 了 解 ASPNET 的 某 种 风格 的 更 多 信息 ， 有 其 他 许多 图 书 可 供 参 考 。 


19.3.1 RARS 


本 节 将 介绍 ASPNET 页 面 框 架 提 供 的 服务 器 控件 。 这 些 控 件 的 设计 目标 是 为 编写 Web 应 用 程序 提供 结构 
化 的 、 事 件 驱 动 的 、 面 向 对 象 的 模型 。 表 19-3 列 出 了 ASPNET 中 可 用 的 主要 Web 服务 器 控件 ， 以 及 这 些 控件 
返回 的 HTML 代码 。 


表 19-3 ASP.NET 服务 器 控件 的 示例 
控件 描述 
Lie EFI F8 CR spn 元 


TextBox <input type="text"> 返回 HTML <input type="text">， 用 户 可 在 其 中 
输入 一 些 值 。 可 编写 服务 器 端的 事件 处 理 程序 来 
处 理 文本 发 生变 化 的 情况 

Button <input type="submit"> 将 表单 值 发 送 给 服务 器 


Hyperlink 创建 一 个 简单 的 错 标签 来 引用 一 个 Web 页 面 


DropDownList <select> 创建 一 个 select 标签 ， 用 户 将 看 到 一 个 条 目 ， 并 
可 单 击 下 拉 列 表 ， 从 多 个 条 目 中 选择 一 个 


CheckBox <input type="checkbox"> 返回 check box 类 型 的 input 元 素 , 显示 一 个 可 被 
选中 或 取消 选中 的 按钮 。 除 了 CheckBox， 还 可 
使 用 CheckBoxList， 它 创建 一 个 包含 多 个 check 
box 元 素 的 表格 

RadioButton <input type="radio"> 返回 radio 类 型 的 input 元 素 。 对 于 单 选 按钮 ， 只 
能 选中 一 组 按钮 中 的 一 个 。 与 CheckBoxList 类 
似 ，RadioButtonList 提供 了 一 个 按钮 列表 
Image <img src=""> 返回 一 个 img 标签 ， 用 于 在 客户 端 显示 GIF 或 
JPG 文件 


还 有 许多 控件 未 在 表 19-3 中 列 出 。 不 过 ， 这 些 控 件 都 具备 如 下 能 力 : 发 送 用 户 调 用 的 事件 ， 可 能 是 自动 发 
送 的 ， 也 可 能 是 作为 页 面 事 件 生命 周期 的 一 部 分 发 送 的 。 这 些 事件 执行 服务 器 新 的 事件 处 理 程序 。 你 会 发 现 ， 
ASPNET 应 用 程序 基本 上 以 这 种 事件 驱动 模型 为 基础 。 


193.2 输入 验证 


当 用 刀 输 入 数据 时 ， 应 该 检查 数据 的 有 效 性 。 检 查 可 在 客户 站 进行 ， 也 可 以 在 服务 器 姗 进行 。 在 客户 痛 检 
可 数据 时 ， 可 使 用 JavaScript。 但 是 ， 如 果 使 用 JavaScript 在 客户 站 检查 了 数据 ， 还 应 该 在 服务 器 站 册 次 检查 ， 
因为 你 不 能 完全 信任 客户 端 。 在 浏览 器 中 是 可 以 茶 用 JavaScript 的 ， 而 且 黑 客 能 够 使 用 可 接收 错误 输入 的 不 同 
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JavaScript 图 数 。 在 客户 闫 检查 数据 可 提 遍 性 能 ， 因 为 在 数据 通过 客户 闯 的 验证 之 前 ， 不 会 在 客 忆 端 和 服务 器 之 
间 来 回 发 送 。 

使 用 ASPNET 时 ， 不 需要 自行 编写 验证 函数 。ASPNET 中 有 许多 验证 控件 可 创建 客户 端 和 服务 器 端 验证 。 
在 下 例 中 ， 验 证 控件 RequiredFieldValidator 与 文本 框 playerlTextBox 关联 在 一 起 。 所 有 验证 控件 都 具有 
ErrorMessage 和 ControlToValidate 属性 。 如 果 输 入 不 正确 ， 将 显示 ErrorMessage 定义 的 消息 。 默 认 情 况 下 ， 在 
验证 控件 的 位 置 显示 错误 消息 。ControlToValidate 属性 定义 了 要 检查 输入 的 控件 。 

<asp:TextBox ID-"playerlTextBox" runat-"server"»«/asp:TextBox» 

«asp:RequiredFieldValidator ID-"RequiredFieldValidatorl" runat-"server" 

ErrorMessage-"Enter a name for player 1" ControlToValidate-"playerlTextBox"- 


</asp:RequiredFieldValidator> 


X 19-4 列 淮 并 搬 述 了 所 有 验证 控件 。 
X 19-4 ASP.NET 验证 控件 示例 


控件 描述 
RequiredFieldValidator 指定 要 验证 的 控件 必须 有 输入 值 。 如 果 要 验证 的 控件 有 初始 值 ， 而 用 户 需 要 修改 这 个 初始 值 ， 
则 可 在 验证 控件 的 InitialValue 属性 中 设置 这 个 初始 值 
RangeValidator 定义 了 允许 用 户 输入 的 最 小 值 和 最 大 值 。 该 控件 的 属性 为 MinimumValue 和 MaximumValue 
CompareValidator 比较 多 个 值 (如 密码 )。 此 验证 控件 不 仅 可 以 比较 两 个 值 是 否 相等 ， 还 可 以 使 用 其 Operator 属性 


设置 其 他 选项 。Operator 属性 的 类 型 为 ValidationCompareOperator， 该 类 型 定义 了 一 些 枚 举 值 ， 
如 Equal, NotEqual, GreaterThan 和 DataTypeCheck。 使 用 DataTypeCheck 时 ， 可 检查 输入 值 是 
不 是 特定 数据 类 型 ， 例 如 是 不 是 正确 的 日 期 输入 


19.3.3 ”状态 管理 

HTTP 协议 是 无 状态 的 。 客 户 闯 肥 出 请 求 时 ， 从 客户 端 到 服务 需 会 建立 连接 ， 请 求 完 成 后 ， 会 关闭 连接 。 
但 是 ， 通 党 从 一 个 页 面 进入 男 一 个 页 面 时 ， 需 要 记 住 一 些 客 己 问 信息 。 这 有 几 种 实现 方法 。 

对 于 可 以 保持 状态 的 各 种 方法 ， 主 要 的 区 别 是 在 客户 端 还 是 服务 器 端 存储 状态 。 表 19-5 概述 了 不 同 的 状态 
党 理 技术 ， 以 及 状态 在 多 长 时 间 内 十 有 效 的 。 


表 19-5 ASP.NET Web Forms 的 状态 管理 技术 


状态 类 型 有 效 时 间 

视图 状态 仅 在 单个 页 面 内 有 效 

cookie 客户 站 浏览 器 关闭 时 ， 将 删除 临时 cookie; 永久 cookie 则 存储 在 客户 
端 系统 的 磁盘 上 

会 话 服务 器 会 话 状态 与 浏览 器 会 话 关联 在 一 起 。 当 经 过 设 定 的 超时 时 间 ( 黑 
WA 20 分钟) 后， 会 话 将 失效 

应 用 程序 服务 器 应 用 程序 状态 被 所 有 客户 端 共享 。 在 服务 器 重启 前 ， 这 个 状态 
是 有 效 的 

缓存 服务 器 类 似 于 应 用 程序 状态 ， 缓 存 也 是 共享 的 。 开 发 人 员 能 控制 缓存 
什么 时 候 失效 


19.3.4 身份 验证 与 授权 


为 保护 网 站 的 安全 ， 可 使 用 身份 验证 来 确认 用 户 具 有 有 效 的 登录 凭据 ， 使 用 授权 确认 通过 喘 份 验证 的 用 户 
能 够 使 用 资源 。 对 于 Web 应 用 程序 ， 稼 用 的 身份 验证 撤 术 包 括 Forms 刁 份 验证 和 Windows 刁 份 验证 。Windows 
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号 份 验证 使 用 Windows 账户 和 IIS 来 验证 用 户 的 身份 ， 而 Forms 里 份 验证 则 需要 使 用 一 个 包含 用 户 访 问 信息 的 
数据 库 。 

ASPNET 包含 许多 用 于 用 户 身 份 验证 的 类 。 在 ASPNET 中 ， 可 使 用 许多 安全 控件 ， 如 Login 和 
PasswordRecovery。 这 些 控 件 使 用 了 Membership API。 使 用 Membership API 可 创建 和 删除 用 户 , 验证 登录 信息 ， 
或 者 获取 关于 当前 登录 的 用 户 的 信息 。Membership API 使 用 一 个 成 员 提 供 程序 。 从 ASPNET 4.5 开始 ， 可 使 用 
不 同 的 提供 程 厅 来 访问 Access 数据 库 、SQL Server 数据 库 或 Active Directory 中 的 用 户 。 也 可 创建 目 定 义 提供 程 
序 来 访问 XML 文件 或 其 他 目 定义 存储 。 

在 下 面 的 “ 试 一 试 ” 中 ， 将 创建 一 个 ASPNET Web Forms 应 用 程序 ， 为 两 个 玩家 发 牌 。 


试 一 试 ”创建 一 个 ASP.NET Web Forms 应 用 程序 


使 用 Visual Studio 2017 创建 一 个 ASP.NET Web Forms 应 用 程序 ,接收 两 个 玩家 的 姓名 ,并 返回 每 个 玩家 
的 牌 。 

(1) f£ Visual Studio 中 ,选择 File | New | Project， 然 后 选择 ASPNET Web Application (NET Framework), i!) 
建 一 个 名 为 Ch19Ex01 的 项 目 ， 如 图 19-5 所 示 ， 然 后 单 击 OK 按钮 。 


P Recent ,NET Framework 4,7 + Sort by: Default -»| iaa B Search (Ctrl+ 日 P- 
4 installed zt 
& ASP.NET Core Web Application Visual C# Type: Visual C$ 
4 Visual Cf Project templates for creating ASP.NET 
Windows Universal ©] ASP.NET Web Application (NET Framework) Visual C# applications. You can create ASP.NET Web 
Forms, MVC, or Web API applications and 


Windows Classic Desktop add many other features in ASP.NET. 


Web 
:NET Core 
.NET Standard 
Cloud 
Test 
WCF 
b Other Languages 
P Other Project Types 


b Online 
Not finding what you are looking for? 
Open Visual Studio Installer 


Name: Ch19Ex01 


Location: CABeginningCSharp/XChapter19^ - Browse... 


Solution name: Ch19Ex01 r4 Create directory for solution 
|| Add to Source Control 


19-5 


(2) 选择 Web Forms， 然 后 单 击 OK 按钮 ， 如 图 19-6 Br. 
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A project template for creating ASP.NET Web Forms 
applications. ASP.NET Web Forms lets you build 
EH m dynamic websites using a familiar drag-and-drop, 
m 《一 event-driven model. A design surface and hundreds of 
Web Forms Web API Single Page controls and components let you rapidly build 
Application sophisticated, powerful Ul-driven sites with data access. 


Learn more 
Azure API App 


Authentication: No Authentication 


Add folders and core references for: 


VY WebForms [ mvc CL! Web api 


(| Add unit tests 


Test project name: Ch19Ex01.Tests 


图 19-6 


(3) 选择 Tools | NuGet Package Manager | Package Manager Console, ‘(ij A fii Install-Package 
Ch18CardLibStandard (如 图 19-7 所 示 )。 


100% ~ d 
Package Manager Console 


Package source: All M tt Default project: Chapter19\Ch19Ex01 
PM» Install-Package Ch18CardLibStandard 


rror List Output Find Symbol Results Breakpoints Call Hierarchy Web Publish Activity 


图 19-7 


TE: 

回顾 一 下 ， 第 18 章 创建 并 使 用 了 Chl8CardLibStandard NET Standard 类 库 。 如 果 在 本 地 安装 了 
Chl8CardLibStandard NET Standard 类 库 ( 和 参见 图 18-12)， 那 么 可 以 在 本 地 安装 该 库 ， 而 不 必 使 用 上 面 的 
Install-Package 命令 。 


要 特别 注意 图 19-7 中 的 Default project fH 
(4) 用 下 面 的 代码 蔡 换 Default.aspx 页 面 中 <% @Page ... %> 指 令 下 方 的 全 部 代码 : 


<asp:Content ID-"BodyContent" ContentPlaceHolderID-"MainContent" 
runat="server"> 
<asp:Table ID-"cardGameTable" runat="server"> 
<asp:TableHeaderRow> 
«asp:TableHeaderCell»Player l«/asp:TableHeaderCell- 
<asp:TableHeaderCell>Player 2</asp:TableHeaderCell> 
</asp: TableHeaderRow> 
<asp:TableRow> 
<asp:TableCell> 
<asp:TextBox ID-"playerlTextBox" runat="server" /> 
«/asp:TableCell- 
<asp:TableCell> 
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<asp:TextBox ID-"player2TextBox" runat="server" /> 
«/asp:TableCell» 
</asp:TableRow> 
<asp:TableRow> 
<asp:Tablecell> 
<asp:RequiredFieldValidator 
ID-"RequiredFieldValidatorplayerlTextBox" 
runat-"server" style-"color:Red;" 
ErrorMessage-"A name for Player 1 is required." 
ControlToValidate-"playerlTextBox"- 
«/asp:RequiredFieldValidator- 
«/asp:TableCell- 
<asp:TableCell> 
«asp:RequiredFieldValidator 
ID-"RequiredFieldValidatorplayer2TextBox" 
runat-"server" style-"color:Red;" 
ErrorMessage-"A name for Player 2 is required." 
ControlToValidate-"player2TextBox"» 
«/asp:RequiredFieldValidator- 
«/asp:TableCell» 
</asp:TableRow> 
«/asp:Table- 
«br /> 
«asp:Button ID-"dealHandButton" runat="server" 
Text-"Deal Hand" 
OnClick-"dealHandButton Click" /> 
«br /» 
<asp:Label ID-"dealtHandLabel" runat="server" Visible-"false" 
Text-"Here are the cards." /> 
«asp:Table ID-"dealtHandsTable" runat-"server" 
Visible-"false" /> 
</asp:Content> 


(5) 在 Default.aspx.cs 代码 隐藏 文件 的 开头 位 置 添加 using Ch18CardLibStandard; P; Hj] . 
(6) 使 用 下 面 的 语法 ， 在 Default.aspx.cs 代码 隐 减 文件 中 创建 dealHandButton ClickO 方 法 : 


protected void dealHandButton Click(object sender, EventArgs e) 
{ 

Player[] players = new Player[2]; 

players[0] = new Player (playerlTextBox.Text) ; 

players[1] = new Player (player2TextBox.Text) ; 


Game newGame = new Game(); 
newGame.SetPlayers (players); 
newGame .DealHands (); 


dealtHandLabel.Visible = true; 
dealtHandsTable.Visible = true; 


foreach (Player player in players) 

{ 
TableHeaderRow tableHeaderRow = new TableHeaderRow(); 
TableHeaderCell tableHeaderCell = new TableHeadercell(); 
tableHeaderCell.Text = player.Name; 
LableHeaderRow.Cells.Add(tableHeaderCell); 
dealtHandsTable.Rows.Add(tableHeaderRow) ; 


TableRow tableRow = new TableRow(); 

foreach (Card card in players[0].PlayHand) 

{ 
TableCell tableCell = new Tablecell(); 
tableCell.Text = "<img width=75 height=100 alt=cardImage ™ + 
"src-https://deckofcards.blob.core.windows.net/carddeck/" + 
S"{card.imageLink} /»"; 
tableRow.Cells.Add(tableCell); 

} 

dealtHandsTable.Rows.Add(tableRow); 

} 
} 


(7) 在 Visual Studio 中 按 F5 或 CtrHF5 $ë, TE IIS Express 中 运行 此 ASPNET Web Forms 应 用 程序 ， 输 入 玩 
家 的 姓名 ， 然 后 按 Deal Hand 按钮 。 
(8) 程序 将 给 每 个 玩家 发 7 张 了 牌 ， 并 呈现 出 来 。 
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示例 说 明 

注意 ， 当 打开 Defaultaspx 文件 时 ， 第 一 行文 本 的 开头 是 <% @Page ... %> 指 令 。 该 指令 中 有 许多 参数 ， 
例如 。 

e Title: (EDU d ENSE ESO AS. 

e Language: 页 面 的 代码 使 用 的 .NET 语言 。 

e MasterPageFile: 对 包含 网 站 样式 配置 的 文件 的 引用 。 将 网 站 样式 代码 放 在 一 个 位 置 ， 这 样 在 不 同 页 面 

之 间 寻 航 时 ， 可 实现 一 致 的 外 观 和 结构 化 体验 。 

e CodeBehind: 包含 表示 层 .aspx 文件 源 代码 的 文件 的 名 称 。 代 码 隐 藏 文件 通 第 是 .aspx.cs 文件 。 

e Inherits: 定义 表示 层 .aspx 文件 的 代码 隐藏 文件 中 的 名 称 空间 和 类 。 

Default.aspx 文件 包含 的 表示 层 标记 语言 可 以 呈现 文本 框 来 接收 玩家 姓名 ， 并 呈现 插 述 玩家 的 相关 标签 。 在 
提交 页 面 以 便 给 玩家 发 牌 之 前 ， 输 入 验证 控件 RequiredFieldValidator 检查 每 个 文本 框 中 是 否 有 值 。 所 有 这 些 控 
件 都 包含 在 Table、TableHeaderRow、TableRow 和 TableCell 控件 中 ， 它 们 在 浏览 器 中 将 演 染 为 table、 也 、ftr 和 
td HTML 格式 。 

在 浏览 器 中 呈现 了 页 面 ， 并 将 值 填 写 到 两 个 文本 框 中 后 ， 单 击 按钮 将 执行 代码 隐藏 文件 中 的 
OnClick="dealHandButton Click" 方 法 。 这 是 Default.aspx.cs 文件 中 的 dealHandButon Click 方法 ， 它 首先 用 两 个 
Player 类 型 的 值 实例 化 一 个 数组 ， 然 后 将 文本 框 的 值 赋 给 每 个 Player 对 象 。 


players[0] = new Player (playerlTextBox.Text); 
players[1] = new Player (player2TextBox.Text) ; 


创建 Game 类 的 一 个 实例 , 通过 将 玩家 数组 传递 给 SetPlayers0 方 法 来 设置 玩家 , 然后 调用 DealHands0 方 法 。 
针对 每 个 玩家 ， 在 一 个 foreach 循环 中 遍历 DealHands0 的 结果 ， 即 两 手 牌 。 该 循环 不 只 提供 纸牌 的 牌 面 大 小 和 
化 色 ， 还 动态 创建 了 表格 、 行 和 单元 格 ， 在 表示 层 中 呈现 内 容 。 还 要 注意 ， 纸 牌 图 片 是 通过 访问 第 16 章 创 建 的 
Azure Blob Storage 容器 来 泻 染 的。 


对 于 快速 创建 功能 完善 的 、 资 源 丰 富 的 Web 应 用 程序 ，ASPNET Web Forms 仍然 是 非常 好 的 选择 。 这 种 风 
格 的 ASPNET 应 用 程序 使 用 完整 版 本 的 NET Framework， 这 意味 着 该 应 用 程序 只 能 在 Microsoft Windows 平台 
上 运行 。 如 果 Web 应 用 程序 需要 在 多 种 操作 系统 上 运行 ， 那 么 ASPNET Core 可 能 是 一 种 更 好 的 选择 。 下 一 节 
将 介绍 ASPNET Core。 


19.4 创建 ASP.NET Core Web 应 用 程序 


本 节 将 讨论 多 个 ASPNET Core 概念 。 在 本 节 中 要 理解 的 最 重要 概念 是 ，ASPNET Core 可 路 平台 运行 。 
与 NET Core 应 用 程序 一 样 ,ASPNET Core 网 站 除了 可 运行 在 Microsoft Windows 上 ,还 可 运行 在 Linux 和 macOS 
上 。 因 此 ， 如 果 Web 应 用 程序 需要 跨 平 台 运 行 ， 就 应 该 使 用 此 ASPNET 风格 进行 开发 。 但 是 ， 如 果 Web 应 用 
程序 只 在 Microsoft Windows 上 运行 ， 则 应 该 考虑 使 用 ASPNET Web Forms 或 ASPNET MVC。 在 撰写 本 书 时 ， 
ASPNET Core 是 ASPNET 家 族 中 最 新 加 入 的 成 员 ， 但 其 二 进 制 中 尚未 包含 所 有 功能 。 这 种 情况 在 将 来 会 发 生 
变化 。 

本 节 将 介绍 ASPNET Core 的 以 下 方面 : 
IIS 和 Kestrel 
Razor 语法 
输入 验证 
状态 管理 
身份 验证 和 授权 
依赖 注入 
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194.1 IIS 和 Kestrel 


直到 现在 ， 当 开发 人 员 谈 到 ASPNET 时 ， 都 会 想到 ，Web 应 用 程序 将 运行 在 Microsoft Windows 服务 器 的 
Internet Information Services (IIS); IIS 是 Microsoft 开发 的 一 个 Web Hees, FY Ma ye Pog ACH I] HTTP 和 
HTTPS 请 求 。 但 因为 IIS 不 能 在 Linux 或 macOS 上 运行 ， 所 以 需要 有 一 种 方法 让 TIS 将 请 求 发 送 给 能 在 那些 操 
作 系 统 上 运行 的 Web 服务 器 。 这 个 问题 的 答案 是 使 用 Kestrel， 这 是 ASPNET Core 项 目 中 包含 的 一 个 新 的 跨 平 
台 Web llt 5 38 . 

如 图 19-8 所 示 ， 当 配置 Kestrel 5 IIS 一 同 运行 时 ， 客 户 站 的 HTTP 请 求 将 被 转发 给 Kestrel Web 服务 器 。 
然后 , Kestrel 通过 传递 HttpContext 类 与 ASPNET Core 源 代码 交互 , HttpContext 类 包含 关于 HTTP 请 求 的 信息 ， 
如 会 话 管理 信息 、 碍 询 字符 串 、 区 域 性 信息 、 客 户 庙 证 书 等 。 


反 向 代理 服务 器 ASPNET Core Web 应 用 程序 
HTTP 
& Pt IIS, Nginx, HTTP HttpContext | 
Apache i Kestrel » > 源 代 码 
ASPNET Core Web 应 用 程序 
HTTP 
客户 端 < Kestrel ERBEN 源 代码 


Z] 19-8 


be f IIS, Apache 和 Nginx 也 是 可 供 使 用 的 Web 服务 器 ， 它 们 只 在 目标 操作 系统 (如 Windows. Linux 或 
macOS) 中 运行 。ASPNET Core 在 运行 时 ， 可 以 没有 任何 特定 于 操作 系统 的 Web 服务 器 ， 因 为 Kestrel 就 是 一 个 
Web 服务 器 。 以 这 种 方式 运行 时 ， 常 称 为 自 托 管 ， 因 为 Web 应 用 程序 和 必要 的 组 件 包 含 在 一 个 专用 容器 中 。 通 
过 这 种 方式 将 Web 应 用 程序 捆绑 在 一 起 ， 使 得 通过 XCOPY 等 部 署 Web 应 用 程序 变 得 很 容易 。 而 且 ， 如 第 16 
草 所 述 ， 可 移植 性 是 云 优化 的 程序 的 一 个 基本 特征 。 


194.2 Razor 语法 


使 用 服务 器 控件 是 ASP.NET Web Forms 的 一 个 基本 设计 原则 ， 但 当 为 ASPNET Core 应 用 程序 创建 Razor 
页 面 时 ， 应 该 使 用 HTML 演 染 功能 ， 而 非 服务 器 控件 。 在 页 和 面 中 引用 变量 时 ， 以 前 的 标记 语法 是 <%= %>， 
这 有 5 个 字符 。Razor 语法 做 出 的 改进 是 使 用 @ 符 号 来 标识 代码 的 起 始 位 置 ， 或 设置 对 变量 的 引用 。 例 如 ， 在 
Razor 页 面 中 添加 隐 兰 字段 时 ， 使 用 @Html.Hidden。HTML 对 象 提供 了 对 System.Web.Mvc.HtmlHelper 类 的 构 
造 函 数 、 属 性 、 字 段 和 方法 的 引用 。 表 19-6 列 出 Razor Web 页 面 中 可 访问 的 一 些 HtmlHelper 方法 。 其 HTML 
输出 与 ASPNET Web Forms 的 服务 器 控件 输出 十 分 相似 。 

表 19-6 Razor HtmlHelper 方法 的 示例 
En m 
Html.Label «Jabel^ 返回 一 个 包含 文本 的 label 元 素 
Html.TextBox <input type="text"> 返回 HTML <input type="text">, 用 户 可 在 其 中 输入 一 些 值 
Html.ActionLink <a href> 创建 一 个 简单 的 锚 标 签 来 引用 一 个 Web 页 面 


Html DropDownList <select> 创建 一 个 select 标签 ， 用 户 将 看 到 一 个 条 目 ， 并 可 单 击 下 
拉 列 表 ， 从 多 个 条 目 中 选择 一 个 
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( 续 表 ) 
m s 
Html.CheckBox <input type="checkbox"> 返回 check box 类 型 的 一 个 input 元 素 ， 显 示 一 个 可 被 选中 
Html.RadioButton <input type="radio"> 返回 radio 类 型 的 一 个 input 元 素 。 对 于 单 选 按钮 ， 只 能 选 
中 一 组 按钮 中 的 一 个 


还 有 其 他 许多 HtmlHelper 方法 未 在 表 19-6 中 列 出 。 


19.4.3 ”输入 验证 


对 ASPNET Core 应 用 程序 的 验证 ， 是 使 用 System.ComponentModel.DataAnnotations 名 称 空间 中 的 验证 特 
性 进行 配置 的 。 验 证 器 在 特定 模型 的 类 定义 中 配置 。 


public class Player 


{ 
[StringLength (20, MinimumLength = 3) ] 
[Required] 
public string Name { get; set; } 

} 


当 请 求 与 已 定义 的 Player 模型 绑 定 在 一 起 的 页 面 时 ，ASPNET Core 的 运行 库 会 生成 jQuery 客户 端 验证 语 
法 。 之 后 ， 如 果 用 户 在 没有 为 Name 提供 值 的 情况 下 提交 表单 ， 客 户 端 将 进行 验证 并 呈现 一 个 错误 。 
表 19-7 列举 并 描述 了 ASPNET Core 的 一 些 数据 注解 验证 特性 。 


Æ 19-7 ASP.NET Core 验证 特性 示例 


控件 摘 述 
Required 指定 该 属性 是 必要 属性 
StringLength 指定 用 户 必 须 输 入 的 最 大 值 以 及 (可 选 的 ) 最 小 值 
Range 对 于 数值 字段 ， 可 设置 最 大 值 和 最 小 值 
EmailAddress 确认 输入 的 值 是 一 个 电子 邮件 地 址 
DataType 确认 输入 的 值 是 特定 类 型 ， 如 Date 或 Currency 
RegularExpression 确认 输入 的 值 匹 配 正 则 表达 式 语 法 


1944 ”状态 管理 


如 前 所 述 ，HTTP 协议 是 无 状态 的 ， 这 意味 看 当 服务 器 成 功 啊 应 请 求 后 ， 不 会 再 存储 及 出 请 求 的 客户 端的 
相关 信息 。 每 个 请 求 完 成 后 ， 将 关闭 并 瑟 记 连接 。 但 当 管 理 客户 闯 的 多 个 请 求 时 ， 和 帝 需 要 人 存储 和 重用 关于 客户 
端的 一 些 信 息 。 与 其 他 ASPNET 风格 一 样 ， 使 用 HTTP 时 ， 可 采用 多 种 方式 来 管理 状态 信息 。 表 19-8 概述 了 
一 些 状态 管理 技术 ， 以 及 状态 的 有 效 时 间 。 


表 19-8 ASP.NET Core 的 状态 管理 技术 

状态 类 型 客户 端 还 是 服务 顺 端 资源 有 效 时 间 
TempData 服务 器 应 用 程序 读 取 数据 后 移 除 
Query Strings 服务 器 和 客户 端 作为 URL 元 素 在 客户 端 和 服务 器 端 传递 ， 只 能 在 单个 请 求 
期 间 访问 
浏览 器 关闭 时 将 删除 临时 cookie; KA cookie 将 存储 到 客 
户 端 系统 的 磁盘 上 
HttpContext.Items 服务 器 与 客户 端 在 客户 端 与 服务 器 之 间 传 递 ， 存 储 在 HttpContext HA, 
只 能 在 单个 请 求 期 间 访 问 


cookie 
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CER) 
状态 类 型 客户 端 还 是 服务 器 端 资源 有 效 时 间 
Cache 服务 器 与 Application 状态 类 似 ， 缓 存 也 是 共享 的 。 但 是 ， 当 需要 
使 缓存 失效 时 ， 有 具有 更 大 的 控制 权 
Session 服务 器 Session 状态 与 浏览 器 会 话 关 联 在 一 起 。 当 经 过 配置 好 的 超 
时 时 间 后 ， 会 话 将 失效 
Application 服务 器 Application 状态 在 所 有 客户 端 之 间 共 享 。 在 服务 器 重启 之 


前 ， 这 个 状态 一 直 有 效 


19.4.5 身份 验证 与 授权 


因为 ASPNET Core 并 非 仅 关注 一 个 操作 系统 ， 所 以 其 身份 验证 和 授权 协议 也 必须 能 路 平台 工作 。OWIN 
Al OAuth 是 最 流行 的 开源 身份 验证 提供 程序 。OWIN 代表 Open Web Interface for .NET, 它 本 和 吴 不 是 一 个 里 份 验 
证 提供 程序 ， 但 OWIN 常 与 Katana 关联 在 一 起 ， 而 Katana 是 一 个 身份 验证 提供 程序 。OWIN 是 一 个 规范 ， 详 
细 规 定 了 Web 服务 器 和 Web 应 用 程序 应 该 如 何 分 离 .OWIN 移 除了 ASPNET Core X} IIS 的 依赖 ,使 得 通过 Kestrel 
实现 目 托管 成 为 现实 。Katana NuGet 包 中 包含 必要 的 库 来 实现 多 类 号 份 验证 ， 如 Windows 和 Forms 身份 验证 。 

OAuth 是 Microsoft, Facebook, Twitter, Google 等 公司 公开 的 一 个 接口 ， 供 Web 应 用 程序 用 来 进行 身份 验 
证 。 在 移动 设备 或 浏 唤 器 中 运行 的 应 用 程序 常 提 示 客 户 端 使 用 Facebook 或 Microsoft 凭据 来 访问 网 站 。 在 这 些 
青 况 中 ， 使 用 的 协议 就 是 OAuth。 在 ASPNET Core Web 应 用 程序 中 实现 OAuth 所 需 的 类 和 方法 包含 在 
AspNet.Security.OAuth.Providers 名 称 空间 中 。 

号 份 验证 过 程 确 认 用 户 确实 是 真实 用 户 。 通 第 ， 当 某 人 创建 一 个 新 账户 时 ， 这 个 账户 会 天 联 一 个 电子 邮件 
地 址 和 一 个 密码 。 应 用 程序 将 向 用 户 提供 的 电子 邮件 地 址 发 送 一 个 确认 邮件 ， 用 户 单 击 这 个 邮件 后 ， 注 册 过 程 
束 完 成 了 。 之 后 ， 使 用 该 电子 邮件 和 密码 来 访问 资源 ， 就 能 验证 确实 是 创建 该 账户 的 用 户 在 访问 资源 。 这 个 过 
程 的 刀 一 个 方面 是 授权 。 授 权 过 程 定 义 了 用 户 能 访问 哪些 功能 和 内 容 。 这 第 称 为 声明 (claim)。 

在 最 简单 的 形式 中 ， 一 些 源 代 码 检查 是 否 存 在 对 茶 个 资源 (如 DealCard0 方 法 ) 的 声明 ， 如 果 存 在 ， 发 出 请 求 
的 发 牌 方丈 能 调用 该 方法 。 

policy.RequireClaim("DealerID"); 

声明 也 可 用 名 - 值 对 形式 表示 ， 从 而 提供 粒度 更 细 的 资源 访问 。 

policy.RequireClaim("DealerID", "1", "2", "3", "4", "5")); 


这 段 代码 表明 ， 只 有 DealerID “EF 1. 2. 3. 4 8 5 的 发 牌 方才 能 调用 DealCard0 方 法 。 
19.4.6 ”依赖 注入 


依赖 注入 (Dependency Injection，DD 是 一 个 非 营 高 级 的 概念 ， 但 是 因为 ASPNET Core 是 以 该 概念 为 基础 构 
建 的 ,所 以 这 里 简单 介绍 一 下 依赖 注入 。 关 于 DI， 要 理解 的 一 个 基本 知识 点 是 ， 在 DI 中 避免 使 用 new 关键 字 。 

player[] players = new Player[2]; 

之 所 以 要 避免 使 用 new， 是 因为 new 关键 字 会 将 程序 与 其 引用 的 类 永久 绑 定 在 一 起 。 一 些 情况 下 ， 需 要 修 
改 关 的 可 能 性 极 低 ， 这 时 使 用 new 关键 字 是 可 以 接受 的 ， 是 否 使 用 该 关键 字 束 是 一 个 设计 决策 。 男 一 个 选项 是 
实现 接口 ， 这 在 第 9 章 、 第 10 章 和 第 12 章 讨 论 过 。 接 口 将 使 用 者 与 提供 程序 松散 地 耦合 在 一 起 ， 或 者 解除 二 
者 的 耦合 ， 这 里 ， 程 序 是 使 用 者 ， 类 是 提供 程序 。 如 下 面 的 代码 段 所 示 ， 在 创建 Player 时 没有 使 用 new 关键 字 。 


public interface ICardGameClient 
{ 


void Player(string Name); 


} 
public class PlaySomeCards 
{ 
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private readonly ICardGameClient  cardGameClient; 
public PlaySomeCards (ICardGameClient cardGameClient) 
_cardGameClient = cardGameClient; 
EA PlayHand 
i _cardGameClient.Player ("Benjamin"); 
} 
依赖 注入 更 进一步 ， 使 用 了 上 所谓 的 工厂 或 容器 。ASPNET Core 默认 文 持 DL JFE Startup.cs 文件 中 配置 
DI. 创建 ASPNET Core Web 应 用 程序 时 ， 会 创建 Startup.cs 文件 。 访 文件 包含 一 个 ConfigureServices0 方 法 ,在 


public void ConfigurServices (IServiceCollection services) 


{ 
services .AddMvc(); 
services .AddDbContext<elassName> (options =>... 
services .Addidentity<classNamel, classNameZ>()... 
} 


当 程 序 代码 发 出 请 求 时 ，ConfigureServices0 方 法 中 配置 的 服务 提供 程序 会 提供 className. 
在 下 面 的 “ 试 一 试 ” 中 ， 将 在 ASPNET Core 中 创建 一 个 Razor 页 面 来 为 两 个 玩家 发 牌 。 


试 一 试 ”在 ASP.NET Core 中 创建 一 个 Razor 页 面 


使 用 Visual Studio 2017， 在 ASPNET Core 中 创建 一 个 Razor 页 面 ， 它 接收 两 个 玩家 的 姓名 ， 并 返回 每 个 玩 
家 的 牌 。 

(1) 选择 File | New | Project | ASENET Core Web Application， 如 图 19-9 所 示 。 将 项 目 命名 为 Ch19Ex02, 2^ 
后 单 击 OK 按钮 。 


P Recent NET Framework 4.7 ~ Sort by: Default -| ši Search (Ctri+E) P- 


cur ral Console App CNET Core) Visual C# Type: Visual C# 
4 Visual C# ce Project templates for creating ASP.NET 
Windows Universal x Class Library (.NET Core) Visual C& Core applications for Windows, Linux and 
: Ta macOS using .NET Core or .NET 
Windows Classic Desktop ce l | | A OE: 
Web JA i Unit Test Project (NET Core) Visual C& 
.NET Core ce 
rorum 内 | Unit Test Project CNET Core) Visual C# 
Cloud 
Test 
WCF 


ASP.NET Core Web Application Visual C+ 


b Other Languages 


b Online 
Not finding what you are looking for? 
Open Visual Studio Installer 
Name: Ch19Ex02 


Location: C\BeginningCSharp/\\Chapter1, 


图 19-9 


(2) 从 下 拉 列 表 中 选择 .NET Core 和 ASPNET Core 2.0， 然 后 选择 Web Application 并 单 击 OK 按钮 ， 如 图 
19-10 所 示 。 


$19 ASP.NET 5 ASP.NET Core | 435 


| NET Core v | ASP.NET Core 2.0 " Learn more 


A project template for creating an ASP.NET Core 


NI | e e application with example ASP.NET Core Razor Pages 


content. 
Empty Web Web Angular 
elie Application 
(Model-View- 
Controller) 


Learn more 


m — 
c | c Ji 
iu mar 


React.js React.js and 
Redux teet 
Change Authentication 


Authentication Mo Authentication 


| ] Enable Docker Support 


OS: Windows 
Requires Docker for Windows 
Docker support can also be enabled later Learn more 


4 19-10 


(3) 选择 Tools | NuGet Package Manager | Package Manager Console, ， 输 入 命令 Install-Package 
Ch18CardLibStandard (如 图 19-11 所 示 )。 
100% ~ 4 


Package Manager Console 


Package source: All - X Default project Chapter19\Ch19Ex02 
PM» Install-Package Ch18CardLibStandard 


10096 ~ 


Error List Output Find Symbol Results Breakpoints Call Hierarchy Web Publish Activity 


图 19-11 


注意 : 

回顾 一 下 ， 第 18 章 创 建 并 使 用 了 Chl8CardLibStandard NET Standard 类 库 。 如 果 在 本 地 安装 了 
Ch18CardLibStandard NET Standard 类 库 ( 参 见 图 18-12)， 那 么 可 在 本 地 安装 该 库 ， 而 不 必 使 用 上 面 的 
Install-Package 命令 。 


(4) 用 下 面 的 代码 替换 Pages/Index.chtml 中 的 代码 : 


@page 
@using Chl8CardLibStandard; 
@{ 
ViewData["Title"] = "BensCards: Deal yourself a hand. "; 
} 
@{ 


Player[] players = new Player[2]: 


string playerl = String.Empty; 
string player2 = String.Empty; 


if (HttpContext.Request.Method —- "POST") 


{ 
playerl = HttpContext.Request.Form["PlayerNamel"]; 
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player? = HttpContext.Request.Form["PlayerName2"]; 


players [0] 
players[1] 


= new Player (playerl); 
= new Player (player2); 
Game newGame = new Game(); 
newGame .SetPlayers (players); 
newGame .DealHands (); 


} 
} 
@if (HttpContext.Request.Method == "GET") 
@Html.Label ("labelGoal", 
"Enter the players name and deal the cards.") 
«br /»«br /» 
@using (Html.BeginForm()) 
{ 
<p>@Html.Label ("labelPlayerl", "Player 1:") 
@Html . TextBox ("PlayerNamel") </p> 
<p>@Html.Label ("labelPlayer2", "Player 2:") 
@Html . TextBox ("PlayerName2") </p> 
<p><input type="submit" value="Deal Hand" class="submit"> 
</p> 
} 
} 
else 
{ 


aHtml.Label("labelGoal", "Here are the cards.") 
«br /><br /> 
<p>@Html.Label ("labelPlayerl", "Player 1:") @playerl</p> 
@foreach (Card card in players [0] .PlayHand) 
{ 
<img width="75" 
height="100" 
alt="cardImage" 
src-"https://deckofcards.blob.core.windows.net/carddeck/ 
@card.imageLink" /> 


<br /><br /> 
<p>@Html.Label ("labelPlayer2", "Player 2:") @player2</p> 
@foreach (var card in players[1] .PlayHand) 
{ 
<img width="75" 
height="100" 
alt-"cardImage" 
src-"https://deckofcards.blob.core.windows.net/carddeck/ 
@card.imageLink" /> 
} 
} 


(5) 在 Visual Studio 中 按 F5 BK Ctrl+FS 键 
名 ， 然 后 单 击 Deal Hand 按钮 。 
(6) 程序 将 给 每 个 玩家 发 7 张 牌 ， 并 谊 染 出 来 。 


， 在 IIS Express 中 运行 此 ASP.NET Core 应 用 程序 。 输入 玩家 的 姓 


示例 说 明 

与 .aspx 文件 一 样 ,，“Page 类 的 引用 ” 负 贡 管理 页 面 的 属性 和 方法 ， 例 如 Context 或 HttpContext. @Page 指 
令 专门 负责 将 Razor 页 面 转换 为 一 个 动作 ， 从 而 不 需要 使 用 控制 器 。 在 ASPNET Core Web 应 用 程序 的 默认 目 
录 中 ， 只 有 一 个 名 为 Pages HE. APA Razor Web 应 用 程序 的 请 求 都 将 被 定 同 到 Pages 文件 夹 ， 该 文件 
夹 作为 默认 的 控制 器 。 当 启动 Web 应 用 程序 时 ， 将 向 Web 服务 器 发 送 一 个 GET 请 求 ， 请 求 Index.cshtml 文件 。 
使 用 一 个 站 语句 检查 HttpContext.Request.Method 值 ， 并 显示 一 个 表单 来 请 求 两 个 玩家 的 姓名 。 


Gif (HttpContext.Request.Method == "GET") 
{ 

@using (Html.BeginForm()) 

{ 

} 


} 
默认 情况 下 ， 当 使 用 Html.BeginForm0 方 法 时 ， 将 把 表单 传 回 自身 。 当 发 生 POST 时 ， 将 执行 下 面 的 代 
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码 段 : 


if (HttpContext.Request.Method == "POST") 
{ 
playerl = HttpContext.Request.Form["PlayerNamel"]; 
player? = HttpContext.Request.Form["PlayerName2"]; 
players[0] = new Player (playerl); 
players[1] = new Player (player2); 
Game newGame = new Game(); 
newGame .SetPlayers (players); 
newGame .DealHands (); 


} 

代码 首先 检查 HttpContext.Request Method 是 否 等 于 POST， 如 果 是 ， 束 访问 HttpContext.Request.Form 集合 
的 内 容 。HttpContextRequestForm 集合 包含 提交 的 表单 中 的 所 有 特性 ， 并 可 按 名 称 索 引 或 数字 索引 访问 。 
PlayerNamel 和 PlayerName2 文本 框 的 值 用 于 创建 Players。 创 建 Game 对 象 并 将 玩家 绑 定 到 游戏 后 ， 回 玩家 发 
牌 。 

最 后 ， 因 为 HttpContext.Request.Method 等 于 POST， 所 以 友 代 及 给 每 个 玩家 的 凰 并 显示 出 来 ， 而 不 是 谊 染 
表单 来 请 求 玩 家 姓名 。 

men (Card card in players [0] .PlayHand) 


«img width-"75" 
height-"100" 
alt-"cardImage" 
src-"https://deckofcards.blob.core.windows.net/carddeck/ 
@card.imageLink" /> 


} 
195 “本章 要 点 
主 oH 要 点 
ASPNET 风格 ASP.NET 应 用 程序 有 很 多 类 型 ， 每 种 应 用 程序 类 型 有 自己 的 使 用 场景 和 优势 


Project 与 Web Site 的 对 比 


服务 器 控件 和 HtmlHelper 


使 用 验证 控件 和 数据 注解 来 验证 用 户 和 输入 


状态 管理 


号 份 验证 和 授权 


Kestrel 


依赖 注入 (DD 


Project 被 编译 成 .dll FFE. Web Site WPA, SROKA RAS 
Web 服务 器 控件 是 服务 器 端 控 件 , A ASP.NET Web Forms 应 用 程序 生成 HIML ft 
码 。HtmlHelper 类 为 在 Razor 页 面 中 创建 Label, Textbox 等 对 象 提供 了 方法 
ASP.NET 提供 了 几 种 验证 控件 , 可 用 来 在 客户 端 和 服务 器 端 方便 地 验证 用 户 输入 。 
出 于 性 能 考虑 ， 会 在 客户 端 进行 验证 ， 但 因为 不 能 信任 Web 客户 端 ， 所 以 还 必须 
在 服务 器 端 进行 验证 

在 Web 应 用 程序 中 ， 必 须 考 虑 在 什么 地 方 存储 状态 。 在 客户 痊 ， 可 使 用 cookie 或 
视图 状态 来 存储 状态 ; 在 服务 器 端 ， 可 使 用 会 话 、 缓 存 和 应 用 程序 对 象 来 存储 状态 
身份 验证 这 个 过 程 用 来 确认 用 户 是 真正 的 用 户 。 授 权 过 程 使 通过 身份 验证 的 客户 端 
能 访问 其 有 权 访 问 的 功能 和 资源 

Kestrel 是 一 个 新 的 Web 服务 器 ， 能 够 自 托管 ASP.NET Core Web 应 用 程序 ， 并 能 
路 平台 运行 

依赖 注入 解除 了 使 用 者 与 提供 程序 的 耦合 


第 IV 部 分 
数据 访问 


> 第 20 章 文件 
> #218 XML 和 JSON 
> 第 22 章 LINQ 


20. 


X ^ 


KFAR: 

File 和 Directory 25 

NET 如 何 使 用 流 来 访问 文件 
如 何 读 写 文件 

如 何 谈 写 压缩 数据 

如 何 序列 化 和 反 序 列 化 对 象 
如 何 监 控 文 件 和 目录 的 变化 


本 章 源 代码 可 通过 本 书 合 作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter20 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 
独 命 名 。 


文件 是 在 应 用 程序 的 实例 之 间 存 储 数 据 的 一 种 便利 方式 ， 也 可 用 于 在 应 用 程序 之 间 传 输 数 据 。 文 件 可 以 存 
储 用 户 和 应 用 程序 配置 ， 以 便 在 下 次 运行 应 用 程序 时 检索 它们 。 

本 章 展 示 如 何在 应 用 程序 中 有 效 地 使 用 文件 , 涉及 用 于 创建 和 读 写 文件 的 主要 类 ， 以 及 文 持 在 C# 代 码 中 处 
理 文件 系统 的 类 。 本 章 不 详细 介绍 全 部 的 类， 但 将 深入 介绍 一 些 类 ， 以 便 读 者 理解 概念 和 基本 理论 。 


20.1 用 于 输入 和 输出 的 类 


读 写 文件 是 把 数据 送 入 C# 程 序 (输入 ) 和 送出 程序 (输出 ) 的 基本 方式 。 因为 文件 用 于 输入 输出 ,所 以 文件 类 
包含 在 System.IO 名 称 空间 中 (IO 是 Input/Output 的 常见 缩写 形式 )。 

System_IO 包含 用 于 在 文件 中 读 写 数据 的 类 ， 只 有 在 C# 应 用 程序 中 引用 此 名 称 空间 才能 访问 这 些 类 ， 而 不 
必 完 全 限定 类 型 名 。 

本 章 将 介绍 如 表 20-1 所 示 的 一 些 类 。 
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File 
Directory 
Path 


FileInfo 


DirectoryInfo 
FileSystemInfo 


FileSystemWatcher 


3€ 20-1. 用 于 访问 文件 系统 的 类 
说 明 

静态 实用 类 ， 提 供 许多 静态 方法 ， 用 于 移动 、 复 制 和 删除 文件 
静态 实用 类 ， 提 供 许 多 静态 方法 ， 用 于 移动 、 复 制 和 删除 目录 
实用 类 ， 用 于 处 理 路 径 名 称 
表示 磁盘 上 的 物理 文件 , 该 类 包含 处 理 此 文件 的 方法 。 要 完成 对 文件 的 读 写 工作 , 就 必须 创建 Stream 
表示 磁盘 上 的 物理 目录 ， 该 类 包含 处 理 此 目录 的 方法 
用 作 FileInfo 和 DirectoryInfo 的 基 类 ， 可 以 使 用 多 态 性 同时 处 理 文件 和 目录 
FileSystemWatcher 是 本 章 要 介绍 的 最 复杂 类 。 它 用 于 监控 文件 和 目录 ， 提 供 了 这 些 文件 和 目录 发 生 
变化 时 应 用 程序 可 以 捕获 的 事件 


本 章 还 将 介绍 System.IO.Compression 名 称 空间 ， 它 允许 读 写 压缩 文件 。 我 们 主要 介绍 以 下 两 个 诉 类 ; 
e DeflateStream 一 一 表示 在 写 入 时 目 动 压缩 数据 或 在 读 取 时 目 动 解压 缩 的 流 ， 使 用 Deflate 算法 来 实现 


e GZipStream 一 一 表示 在 写 入 时 目 动 压缩 数据 或 在 读 取 时 目 动 解压 缩 的 流 , 使 用 GZIP(GNU Zip) 复 法 来 实 


BUR A o 


20.1.4 File 类 和 Directory 类 


File 和 Directory 实用 关 提 供 了 许多 静态 方法 ， 用 于 处 理 文件 和 目录 。 这 些 方法 可 以 移动 文件 、 查 询 和 更 新 
特性 ， 还 可 以 创建 FileStream 对 象 。 如 第 8 章 所 述 ， 可 以 在 类 上 调用 裔 态 方法 ， 而 不 必 创 建 它们 的 实例 。 
File 其 的 一 些 最 利用 静态 方法 如 表 20-2 所 示 。 


方 法 
CopyU 
Create() 
Delete() 
Open() 
Move() 


$ 20-2 File 类 的 静态 方法 


说 明 
将 文件 从 源 位 置 复制 到 目标 位 置 
在 指定 的 路 径 上 创建 文件 
删除 文件 


返回 指定 路 径 上 的 FileStream 对 象 
将 指定 的 文件 移 到 新 位 置 。 可 在 新 位 置 为 文件 指定 不 同名 称 


Directory 类 的 一 些 帝 用 毅 态 方法 如 表 20-3 所 示 。 


方 法 
CreateDirectory() 
Delete() 
GetDirectories() 


EnumerateDirectories() 
GetFiles() 
EnumerateFiles() 


GetFileSystemEntries() 


表 20-3 Directory 类 的 静态 方法 
说 明 

创建 具有 指定 路 径 的 目录 
删除 指定 的 目录 及 其 中 的 所 有 文件 
返回 表示 指定 目录 下 的 目录 名 的 string 对 象 数组 
与 GetDirectories0 类 似 ， 但 返回 目录 名 的 IEnumerable<srze> 集 合 
返回 在 指定 目录 中 的 文件 名 的 string 对 象 数组 
与 GetFiles0O 类 似 ， 但 返回 文件 名 的 [Enumerable<strine> ES 
返回 指定 目录 中 的 文件 和 目录 名 的 string 对 象 数 组 


EnumerateFileSystemEntries() 与 GetFilesSystemEntnies0 类 似 ， 但 返回 文件 和 目录 名 的 IEnumerablecstring^ EA 


Move() 


将 指定 目录 移 到 新 位 置 。 可 在 新 位 置 为 文件 夹 指 定 一 个 新 名 称 
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存在 大 量 文 件 或 目录 时 ， 其 中 的 3 个 EnumerateXxx0 方 法 的 性 能 比 对 应 的 GetXxx077 1:44 . 
20.1.2 Filelnfo 类 


与 File 类 不 同 ，FileInfo 类 不 是 静态 的 ， 没 有 静态 方法 ， 只 有 在 实例 化 后 才 可 使 用 。FileInfo 对 象 表示 磁盘 
或 网 络 位 置 上 的 文件 。 提 供 文 件 路 径 ， 就 可 以 创建 一 个 FileInfo 对 象 : 


FileInfo aFile = new FileInfo(@"C:\Log.txt"); 


注意 : 

本 章 处 理 的 是 表示 文件 路 径 的 字符 串 ， 该 字符 串 中 有 许多 “ 必 字符 ， 所 以 上 述 字符 串 的 前 缓 @ 表 示 这 个 字 
符 串 应 按 字面 意义 解释 ，“\” 解 释 为 “\”， 而 不 解释 为 转 义 字符 。 如 果 没 有 @ 前 级 ,就 需要 用 “\\” 赫 代 “\”， 
以 免 把 这 个 字符 解释 为 转 义 字符 。 本 章 总 是 在 字符 串 前 面 如 上 前 缓 @. 


在 路 径 名 中 ， 你 也 可 以 使 用 “/” 字符 。 但 那样 的 话 ， 当 执行 的 Windows 命令 为 命令 行 选项 使 “/” 时 ， 将 
会 发 生 冲 突 。 

也 可 将 目录 名 传递 给 FileInfo 构造 函数 ， 但 实际 上 这 并 不 是 很 有 用 。 这 么 做 会 用 所 有 的 目录 信息 初始 化 
FileInfo 的 基 类 FilesSystemInfo, {4 FileInfo 中 与 文件 相关 的 专用 方法 或 属性 都 不 会 工作 。 

FileInfo 类 提供 的 许多 方法 类 似 于 File 类 的 方法 ， 但 由 于 File 是 静态 类 ， 它 需要 一 个 字符 串 参数 为 每 个 方 
法 调用 指定 文件 位 置 。 因 此 ， 下 面 的 调用 可 以 完成 相同 的 工作 : 

FileInfo aFile — new FileInfo("Data.txt"); 

if (aFlle.Exists) 

WriteLine ("File Exists"); 
if (File.Exists ("Data.txt") ) 
WriteLine ("File Exists"); 

这 段 代 码 检查 文件 Data.txt 是 合 人 存在。 注意 ， 这 里 没有 指定 任何 目录 信息 ， 这 说 明 上 只 检查 当前 的 工作 目录 。 
这 个 目录 包含 调用 此 代码 的 应 用 程序 。20.1.4 节 “ 路 径 名 和 相对 路 径 ” 将 详细 介绍 这 一 内 容 。 

FileInfo 类 的 许多 方法 与 File 类 中 的 对 应 方法 类 似 。 大 多 数 情况 下 使 用 什么 技术 并 不 重要 , 但 下 面 的 规则 有 
助 于 确定 哪 种 技术 更 合适 : 

e 如 果 仅 进行 单一 方法 调用 ， 则 可 使 用 静态 File 类 上 的 方法 。 在 此 ， 单 一 调用 要 快 一 些 ， 因 为 NET 

Framework 不 必 实 例 化 新 对 象 ， 再 调用 方法 。 
e 如 果 应 用 程序 在 文件 上 执行 几 种 操作 ， 则 实例 化 FileInfo 对 象 并 使 用 其 方法 就 更 好 一 些 。 这 节省 时 间 ， 
因为 对 象 已 在 文件 系统 上 引用 正确 的 文件 ， 而 静态 类 必须 每 次 部 寻找 文件 。 

FileInfo 类 也 提供 了 与 底层 文件 相关 的 属性 ， 其 中 一 些 属性 可 用 来 更 新 文件 ， 其 中 很 多 属性 都 继承 于 

FileSystemInfo， 所 以 可 应 用 于 FileInfo 和 DirectoryInfo #8. FileSystemInfo 类 的 属性 如 表 20-4 所 示 。 


表 20-4 FileSystem 的 属性 


属 性 说 明 

Attributes 使 用 FileAttributes 枚 举 ， 获 取 或 者 设置 当前 文件 或 目录 的 特性 
Nip 获取 当前 文件 的 创建 日 期 和 时 间 ， 可 使 用 UTC 和 非 UTC 版 本 

Creation TimeUtc 

Extension 提取 文件 的 扩展 名 。 这 个 属性 是 只 读 的 

Exists 确定 文件 是 否 存在 ， 这 是 一 个 只 读 的 抽象 属性 ， 在 FileInfo 和 DirectoryInfo 中 进行 了 重 写 
FullName 检索 文件 的 完整 路 径 ， 这 个 属性 是 只 读 的 

NC 获取 或 设置 上 次 访问 当前 文件 的 日 期 和 时 间 ， 可 使 用 UTC 和 非 UTC 版 本 
LastAccessTimeUtc 

cR 获取 或 设置 上 次 写 入 当前 文件 的 日 期 有 和 时间， 可 使 用 UTC 和 非 UTC 版 本 
LastWrite TimeUtc 


Name 检索 文件 的 完整 路 径 ， 这 是 一 个 只 读 抽 象 属性 ， 在 FileInfo 和 DirectoryInfo 中 进行 了 重 写 
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FileInfo 的 专用 属性 如 表 20-5 所 示 。 


表 20-5 Filelnfo 的 属性 


mR 性 be 
Directory 检索 一 个 DirectoryInfo 对 象 ， 表 示 包 含 当前 文件 的 目录 。 这 个 属性 是 只 读 的 
DirectoryName 返回 文件 目录 的 路 径 。 这 个 属性 是 只 读 的 
IsReadOnly 文件 只 读 特性 的 快捷 方式 。 也 可 以 通过 Attributes 来 访问 这 个 属性 
Length 获取 文件 的 大 小 (以 字 节 为 单位 )， 返 回 long 值 。 这 个 属性 是 只 读 的 


20.1.3 DirectoryInfo 类 


DirectoryInfo 类 的 作用 类 似 于 FleInfo 类 。 它 是 一 个 实例 化 的 对 象 ， 表 示 计 算 机 上 的 单一 目录 。 与 FileInfo 
类 一 样 ， 在 Directory 和 DirectoryInfo 之 间 存 在 许多 类 似 的 方法 调用 。 选 择 使 用 File 或 FileInfo 方法 的 规则 也 
适用 于 DirectoryInfo 方法 : 

e WRT — JH, wi PAS Directory 25. 

e 如 果 执 行 一 系列 调用 ， 则 使 用 实例 化 的 DirectoryInfo 对 象 。 

DirectoryInfo 类 的 大 多 数 属性 继承 自 FileSystemInfo， 与 FileInfo 类 一 样 ， 但 这 些 属性 作用 于 目录 上 ， 而 不 
是 文件 上 。 还 有 两 个 DirectoryInfo 专用 属性 ， 如 表 20-6 所 示 。 


%z 20-6 DirectoryInfo 类 的 专用 属性 


属 性 说 明 
Parent 检索 一 个 DirectoryInfo 对 象 ， 表 示 包 含 当前 目录 的 目录 。 这 个 属性 是 只 读 的 
Root 检索 一 个 DirectoryInfo 对 象 ， 表 示 包 含 当 前 目录 的 根 目 录 ， 例 如 C+\ 目 录 。 这 个 属性 是 只 该 的 


20.1.4 ”路 径 名 和 相对 路 径 


在 .NET 代码 中 指定 路 径 名 时 ， 可 使 用 绝对 路 径 名 ， 也 可 以 使 用 相对 路 径 名 。 绝 对 路 径 名 显 式 地 指定 文件 或 
目录 来 目 于 哪 一 个 已 知 的 位 置 ， 比 如 C: 驱 动 右 。 它 的 一 个 示例 是 C:\Work\LogFile.txt。 注 意 这 个 路 径 准 确 地 定 
义 了 其 位 置 。 

相对 路 径 名 相对 于 一 个 起 始 位 置 。 使 用 相对 路 径 名 时 ， 不 必 指 定 驱 动 右 或 已 知 的 位 置 ， 前面 的 当前 工作 目 
录 束 是 起 点 ， 这 是 相对 路 径 名 的 默认 设置 。 例 如 ， 如 果 应 用 程序 运行 在 C:\Development\FileDemo 目录 上 ， 并 使 
用 相对 路 径 LogFile.txt, AMF RAE C:\Development\ FileDemo\LogFile.txt。 为 上 移 目 录 ， 要 使 用 .字符 串 。 这 样 ， 
在 同一 个 应 用 程序 中 ， 路 径 .\Logtxt 表示 C:\Development\ Log.txt 文件 。 

如 前 所 述 ， 工 作 目 录 起 初 设 置 为 运行 应 用 程序 的 目录 。 当 使 用 Visual Studio 开发 程序 时 ， 这 就 表示 应 用 程 
序 是 所 创建 的 项 目 文 件 夹 下 的 几 个 目录 。 它 通 第 位 于 ProjectName bin Debug 中 。 要 访问 项 目 根 文件 夹 中 的 文件 ， 
必须 用 .\.\ 上 移 两 个 目录 ， 这 在 本 章 中 十 分 常见 。 

如 有 必要 ， 可 使 用 DirectoryGetCurentDirectory0 找 出 工作 目录 的 当前 设置 ， 也 可 以 使 用 Directory.SetCurrent- 
DirectoryO 设 置 新 路 径 。 
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20.2 itt 


在 .NET Framework 中 进行 的 所 有 输入 和 输出 工作 都 要 用 到 流 (stream)。 流 是 序列 化 设备 (serial device) 的 抽象 
表示 。 序 列 化 设备 可 以 线性 方式 存储 数据 ， 并 可 按 同 样 的 方式 访问 : 一 次 访问 一 个 字 节 。 此 设备 可 以 是 磁盘 文 
件 、 网 络 通 道 、 内 存 位 置 或 其 他 支持 以 线性 方式 读 写 的 对 象 。 把 设备 变 成 抽象 的 ， 就 可 以 隐藏 流 的 底层 目标 和 
源 。 这 种 抽象 级 别 文 持 代 码 重 用 ， 人 允许 编写 更 通用 的 例 程 ， 因 为 不 必 担 心 数据 传输 方式 的 特性 。 因 此 ， 当 应 用 
程序 从 文件 得 入 流 、 网 络 输入 流 或 其 他 流 中 读 取 数据 时 ， 就 可 以 传输 和 重用 类 似 的 代码 。 而 且 ， 使 用 文件 流 还 
可 以 忽略 每 种 设备 的 物理 机 制 ， 不 必 担 心 硬 盘 磁 头 或 内 存 分 配 问 题 。 

流 可 以 表示 几乎 所 有 源 ， 例 如 键盘 、 物 理 磁 盘 文 件 、 网 络 位 置 、 打 印 机 。 甚 至 另 一 个 程序 ， 但 本 章 仅 关注 
磁盘 文件 的 读 写 。 适 用 于 读 写 磁盘 文件 的 概念 ， 也 适用 于 大 多 数 设 备 ， 所 以 读者 可 以 基本 理解 流 的 概念 ， 学 习 
可 用 于 许多 情形 的 、 已 证 明 有 效 的 方法 。 


20.2.1 使 用 流 的 类 
使 用 流 的 类 ， 与 File 和 Directory 类 一 样 ， 也 包含 在 System.IO 名 称 空间 中 。 这 些 类 如 表 20-7 所 示 。 


表 20-7 流 类 
类 说 RB 
FileStream 表示 可 写 或 可 读 ， 或 二 者 均 可 的 文件 。 可 以 同步 或 异步 地 读 写 此 文件 
StreamReader 从 流 中 读 取 字符 数据 ， 可 使 用 FileStream 作为 基 类 创建 
Stream Writer 同 流 写 入 字符 数据 ， 可 使 用 FileStream 作为 基 类 创建 


下 面 看 看 如 何 使 用 这 些 类 。 
20.2.2 FileStream 对 象 


FileStream 对 象 表示 指 同 磁盘 或 网 络 路 径 上 的 文件 的 流 。 这 个 类 提供 了 在 文件 中 读 写 字 节 的 方法 ， 但 经 贡 
使 用 StreamReader 或 StreamWriter 执行 这 些 功能 。 这 是 因为 FileStream 类 操作 的 是 字 节 和 字 节 数组 ， 而 Stream 
类 操作 的 是 字符 数据 。 和 字符 数据 易于 使 用 ， 但 是 有 些 操 作 ， 如 随机 文件 访问 (访问 文件 中 间 条 点 的 数据 )， 就 必 
须 由 FileStream 对 象 执行 ， 本 章 稍 后 对 此 进行 介绍 。 

还 有 几 种 方法 可 以 创建 FileStream 对 象 。 其 构造 函数 具有 许多 不 同 的 重 载 版 本， 最 简单 的 构造 国 数 仅 有 两 
个 参数 ， 即 文件 名 和 FileMode 枚 举 值 。 

FileStream aFile = new FileStream(filename, FileMode.<Member>); 

FileMode 枚 举 包含 几 个 成 员 ， 指 定 了 如 何 打开 或 创建 文件 。 稍 后 介绍 这 些 枚 举 成 员 。 另 一 个 常用 的 构造 函 
数 如 下 : 


FileStream aFile = 
new FileStream(filename, FileMode.<Member>, FileAccess.«Member-); 


第 三 个 参数 是 FileAccess 枚 举 的 一 个 成 员 ， 它 指定 了 流 的 作用 。FileAccess 枚 举 的 成 员 如 表 20-8 所 示 。 


$ 20-8 FileAccess 枚 举 成 员 
成 说 明 
Read 打开 文件 ， 用 于 只 读 
Write 打开 文件 ， 用 于 只 写 


ReadWrite 打开 文件 ， 用 于 读 写 


0 
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对 文件 进行 非 FileAccess 枚 举 成 员 指 定 的 操作 会 导致 抛 出 异 彰 。 此 属性 的 作用 是 ， 基 于 用 户 的 权限 级 别 改 
变 用 户 对 文件 的 访问 权限 。 
TE FileStream 构造 函数 不 使 用 FileAccess 枚 举 参数 的 版 本 中 ， 使 用 默认 值 FileAccess. ReadWrite. 
FileMode 枚 举 成 员 如 表 20-9 所 示 。 使 用 每 个 值 会 发 生 什 么 ， 取 诀 于 指定 的 文件 名 是 否 表 示 已 有 的 文件 。 注 
意 ， 这 个 表 中 的 项 表示 创建 流 时 该 流 指 同文 件 中 的 位 置 ， 下 一 节 将 详细 讨论 这 个 主题 。 除 非特 别 说 明 ， 人 否则 流 
就 指 同文 件 的 开头 处 。 
表 20-9 FileMode 枚 举 成 员 


Rica 打开 文件 ， 流 指向 文件 的 末尾 处 ， 只 能 与 枚 举 FileAccess.Write | 创建 一 个 新 文件 。 只 能 与 枚 举 
en 


结合 使 用 FileAccess. Write 结合 使 用 
Create 删除 该 文件 ， 然 后 创建 新 文件 创建 新 文件 
= ENSA 
Open 打开 文件 ， 流 指 癌 文件 开头 处 抛 出 异常 
OpenOrCreate 打开 文件 ， 流 指 同文 件 开头 处 创建 新 文件 
打开 文件 ， 清 除 其 内 容 。 流 指 问 文 件 开头 处 ， 保 留 文 件 的 初始 创 | ， | 
Truncate 抛 出 异常 


建 日 期 


File 和 FileInfo 类 部 提供 了 OpenRead()fll OpenWrite() 方 法 ， 更 易于 创建 FileStream 对 象 。 前 者 打开 了 只 该 
访问 的 文件 ， 后 者 只 允许 写 入 文件 。 这 些 都 提供 了 快捷 方式 ， 因 此 不 必 以 FileStream 构造 图 数 的 参数 形式 提供 
所 有 必要 的 信息 。 例 如 ， 下 面 的 代码 行 打开 了 用 于 只 读 访 问 的 Data.txt 文件 : 

FileStream aFile = File.OpenRead("Data.txt"); 

下 面 的 代码 执行 同样 的 功能 : 


FileInfo aFileInfo = new FileInfo("Data.txt"); 
FileStream aFile = aFileInfo.OpenRead():; 


1. 文件 位 置 

FileStream 关 维 护 内 部 文件 指针 ， 访 指针 指 同文 件 中 进行 下 一 次 读 与 操作 的 位 置 。 大 多 数 情况 下 ， 当 打开 
文件 时 ， 它 束 指 癌 文件 的 开始 位 置 ， 但 是 可 以 修改 此 指针 。 这 允许 应 用 程序 在 文件 的 任何 位 置 读 写 ， 随 机 访问 
文件 ， 或 直接 跳 到 文件 的 特定 位 置 上 。 当 处 理 大 型 文件 时 ， 这 非常 省 时 ， 因 为 马上 融 可 以 找到 正确 位 置 。 

实现 此 功能 的 方法 是 Seek0 方 法 ， 它 有 两 个 参数 : 第 一 个 参数 指定 文件 指针 移动 距离 (以 字 节 为 单位 )。 第 
二 个 参数 指定 开始 计算 的 起 始 位 置 ,用 SeekOrigin 枚 举 的 一 个 值 表示 。SeekOrigin 枚 举 包含 3 “MH: Begin. Current 
和 End。 

例如 ， 下 面 的 代码 行将 文件 指针 移 到 文件 的 第 8 个 字 节 处 ， 其 起 怒 位 置 就 是 文件 的 第 1 SEA: 

aFile.Seek(8, SeekOrigin.Begin); 

下 面 的 代码 行将 文件 指针 从 当前 位 置 开 始 向 前 移动 2 SE RE EST ZT PAR, 
文件 指针 融 指 同文 件 的 第 10 PST: 

aFile.Seek(2, SeekOrigin.Current); 


注意 读 写 文件 时 ， 文 件 指针 会 随 之 改变 。 在 读 取 了 10 个 字 节 之 后 ， 文 件 指针 就 指向 被 读 取 的 第 10 个 字 节 
之 后 的 字 节 。 

也 可 以 指定 负 傅 找 位 置 ， 这 可 与 SeekOrigin.End 枚 举 值 一 起 使 用 ， 俘 找 菲 近 文 件 末 新 的 位 置 。 下 面 的 代码 
会 查找 文件 中 的 倒数 第 5 NFH: 
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aFile.Seek(-5, SeekOrigin.End); 


采用 这 种 方式 访问 的 文件 有 时 称 为 随机 访问 文件 ， 因 为 应 用 程序 可 以 访问 文件 中 的 任何 位 置 。 稍 后 介绍 的 
StreamReader 和 StreamWriter 类 可 连续 访问 文件 ， 但 不 允许 以 这 种 方式 操作 文件 指针 。 

2. 读 取 数据 

使 用 FileStream 类 读 取 数据 不 像 使 用 本 章 后 面 介绍 的 StreamReader 类 读 取 数据 那样 容易 。 这 是 因为 
FileStream 类 只 能 处 理 原 妨 字 市 (raw byte)。 处 理 原 始 字 节 的 功能 使 FileStream 类 可 以 用 于 任何 数据 文件 ， 而 不 
仅 是 文本 文件 。 通 过 读 取 字 市 数据 ，FileStream 对 象 可 用 于 读 取 诸如 图 像 和 声音 的 文件 。 这 种 灵活 性 的 代价 是 ， 
不 能 使 用 FileStream 类 将 数据 直接 读 入 字符 串 ， 而 使 用 StreamReader 类 却 可 以 这 样 处 理 。 但 是 有 几 种 转换 类 可 以 
很 轻易 地 将 字 节 数组 转换 为 字符 数组 ， 或 将 字符 数组 转换 为 字 节 数组 。 

FileStream .Read0 方 法 是 从 FileStream 对 象 所 指 回 的 文件 中 访问 数据 的 主要 手段 。 这 个 方法 从 文件 中 读 取 数 
据 ， 再 把 数据 写 入 一 个 字 节 数组 。 它 有 三 个 参数 : 第 一 个 参数 是 传 入 的 字 节 数组 ， 用 来 接受 FileStream 对 象 中 
的 数据 。 第 二 个 参数 是 字 节 数组 中 开始 写 入 数据 的 位 置 ， 它 通常 是 0， 表 示 从 数组 开端 同文 件 中 写 入 数据 。 最 
后 一 个 参数 指定 从 文件 中 读 出 多 少 字 市 。 

下 例 演 示 了 从 随机 访问 文件 中 读 取 数 据 。 要 读 取 的 文件 实际 是 为 此 示例 创建 的 类 文件 。 


试 一 试 ”从 随机 访问 文件 中 读 取 数据 : ReadFile\Program.cs 


(1) f£ C:\BeginningCSharp7\Chapter20 目录 中 创建 一 个 新 的 控制 台 应 用 程序 ReadFile。 
(2) 在 Program.cs 文件 的 项 部 添加 下 面 的 using 指令 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using System. Threading.Tasks; 
using System.IO; 


(3) 在 Main0 方 法 中 添加 以 下 代码 : 


static void Main(string[] args) 
{ 
byte[] byteData = new byte[200]; 
char[] charData = new char[200]; 
try 
{ 
FileStream aFile = new FileStream(@"..\..\Program.cs", FileMode.Open); 
aFile.Seek(174, SeekOrigin.Begin) ; 
aFile.Read(byteData, 0, 200); 
} 
catch (IOException e) 
{ 


WriteLine ("An IO exception has been thrown!"); 
WriteLine (e.ToString()); 

ReadKey (); 

return; 


Decoder d = Encoding.UTF8.GetDecoder(); 
d.GetChars(byteData, 0, byteData.Length, charData, 0); 
WriteLine(charData); 
ReadkKey () ; 

} 


(4) 运行 该 应 用 程序 。 结 果 如 图 20-1 所 示 。 
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à | CABeginningC Sharp Chapter ReadFile ReadFile bin Debug ReadFile, exe = ü *X | 


图 20-1 


示例 说 明 
此 应 用 程序 打开 自己 的 .cs 文件 ,用 于 从 中 读 取 数据 。 它 在 下 面 的 代码 行 中 使 用 . . 字符 串 向 上 逐 级 导航 两 个 
目录 ， 找 到 该 文件 : 
FileStream aFile = new FileStream("../../Program.cs", FileMode.Open); 
下 面 两 行 代 码 执行 实际 的 查找 工作 ， 并 从 文件 的 具体 位 置 读 取 字 他: 


aFile.Seek(174, SeekOrigin.Begin); 
aFile.Read(byteData, 0, 200); 


第 一 行 代码 将 文件 指针 移 到 文件 的 第 174 个 字 节 。 在 Program.cs 文件 中 ， 是 namespace 中 的 "n^; 其 前 面 
的 174 个 字符 是 using 指令 。 第 二 行将 接 下 来 的 200 个 字 节 读 入 byteData Fi BAF. 


try 

{ 
aFile.Seek(113, SeekOrigin.Begin); 
aFile.Read(byteData, 0, 100); 


atch (IOException e) 
l WriteLine ("An IO exception has been thrown!"); 
WriteLine (e.ToString()); 
ReadKey () ; 
return; 
] 
涉及 文件 VO 的 所 有 操作 几乎 都 可 抛 出 IOException 2878 [f] Fs. ATA i FARE UBL 1 AC PUER VA EE , 
在 处 理 文件 系统 时 尤其 如 此 。 本 章 的 所 有 示例 部 包含 基本 的 错误 处 理 代码 。 
从 文件 中 获取 了 字 节 数组 后 ， 就 需要 将 其 转换 为 字符 数组 ， 以 便 在 控制 台 显 示 它 。 为 此 ， 使 用 System. Text 
名 称 空间 的 Decoder 类 。 此 关 用 于 将 原始 字 节 转换 为 更 有 用 的 项 ， 比 如 字符 : 


Decoder d = Encoding.UTF8.GetDecoder (); 
d.GetChars (byteData, 0, byteData.Length, charData, 0); 


这 些 代 码 基于 UTF-8 编码 模式 创建 了 Decoder 对 象 ， 这 束 是 Unicode 编 码 模式 。 然 后 调用 GetChars0 方 法 ， 此 
方法 接受 一 个 字 节 数组 作为 参数 ， 将 其 转换 为 字符 数组 。 完 成 后 ， 融 可 将 字符 数组 输出 到 控制 台 。 

3. 写 入 数据 

器 随 机 访问 文件 中 写 入 数据 的 过 程 与 从 中 读 取 数 据 非 常 类似 。 首 先 需 要 创建 一 个 字 节 数组 ， 最 简单 的 办 法 
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是 首先 构建 要 写 入 文件 的 字符 数组 。 然 后 使 用 Encoder 对 象 将 其 转换 为 字 节 数 组 ， 其 用 法 非常 类 似 于 Decoder 
WA. BAVA Write0 方 法 ， 将 字 节 数组 传送 到 文件 中 。 
下 面 构建 一 个 简 早 的 示例 演示 其 过 程 。 


试 一 试 ”将 数据 写 入 随机 访问 文件 : WriteFile\Program.cs 


(1) Æ C:\BeginningCSharp7\Chapter20 目录 中 创建 一 个 新 的 控制 台 应 用 程序 WriteFile。 
(2) 在 Program.cs 文件 项 部 添加 下 面 的 using 指令 : 


using System; 

using System.Collections.Generic; 
using System. Ling; 

using System. Text; 

using System. Threading.Tasks; 
using System. IO; 


(3) 在 Main0 方 法 中 添加 下 面 的 代码 : 


static void Main(string[] args) 
{ 
byte[] byteData; 
char[] charData; 
try 
{ 
FileStream aFile = new FileStream("Temp.txt", FileMode.Create) ; 
charData = "My pink half of the drainpipe.".ToCharArray(); 
byteData = new byte[charData.Length]; 
Encoder e = Encoding.UTF8.GetEncoder(); 
e.GetBytes(charData, 0, charData.Length, byteData, 0, true); 
// Move file pointer to beginning of file. 
aFile.Seek(0, SeekOrigin.Begin) ; 
aFile.Write(byteData, 0, byteData.Length) ; 
} 
catch (IOException ex) 
WriteLine ("An IO exception has been thrown!"); 
WriteLine (ex.ToString()); 
ReadKey () ; 
return; 
) 
} 
(4) 运行 该 应 用 程序 。 它 在 短暂 运行 后 将 会 天 闭 。 
(5) 导航 到 应 用 程序 目录 一 一 在 目录 中 已 经 保存 了 文件 ， 因 为 我 们 使 用 了 相对 路 径 。 目 录 位 于 
WriteFile\bin\Debug 文件 夹 中 。 打 开 Temp.txt 文件 。 可 在 文件 中 看 到 如 图 20-2 所 示 的 文本 。 


“| Temp - Notepad = [1 X 
| File Edit Format View Help 
My pink half of the drainpipe. 


到 20-2 


示例 说 明 

此 应 用 程序 打开 目 己 目录 中 的 文件 ， 并 在 文件 中 写 入 了 一 个 简单 字符 串 。 这 个 示例 的 结构 非常 类 似 于 前 面 
的 示例 ， 只 是 用 Write0 蔡 代 了 Read, HĦ Encoder £X | Decoder. 

下 面 的 代码 行使 用 String 类 的 ToCharArray0 方 法 ， 创 建 了 字符 数组 。 因 为 C# 中 的 所 有 事物 都 是 对 象 ， 文 
本 “My pink half of the drainpipe.” 实 际 上 是 一 个 String 对 象 (尽管 有 点 儿 怪 )， 所 以 甚至 可 在 字符 串 上 调用 这 些 
静态 方法 。 


CharData = "My pink half of the drainpipe.".ToCharArray(); 


下 面 的 代码 行 显示 了 如 何 将 字符 数组 转换 为 FileStream 对 象 需要 的 正确 字 节 数组 。 
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Encoder e = Encoding.UTF8.GetEncoder (); 
e.GetBytes (charData, 0, charData.Length, byteData, 0, true); 


这 次 ， 要 基于 UTF-8 编码 方法 来 创建 Encoder 对 象 。 也 可 将 Unicode 用 于 解码 ， 此 时 在 写 入 流 之 前 ， 需 要 
将 字符 数据 编码 为 正确 的 字 节 格式 。 在 GetBytes0 方 法 中 可 以 完成 这 些 工作 , 它 可 将 字符 数组 转换 为 字 节 数组 。 
GetByte0 方 法 将 字符 数组 作为 第 一 个 参数 (本 例 中 的 charData)， 将 该 数组 中 起 始 位 置 的 下 标 作为 第 二 个 参 
数 (0 表示 数组 的 开头 )。 第 三 个 参数 是 要 转换 的 字符 数量 (charDataLength，charData 数组 中 元 素 的 个 数 )。 第 四 
个 参数 是 在 其 中 放 入 数据 的 字 节 数组 (byteData), 第 五 个 参数 是 在 字 节 数组 中 开始 写 入 位 置 的 索引 (0 表示 byteData 
数组 的 开头 )。 

最 后 一 个 参数 决定 在 结束 后 Encoder 对 象 是 否 应 该 更 新 其 状态 , 这 反映 了 一 个 事实 : Encoder 对 象 在 内 存 中 
保持 记录 它 原来 在 字 节 数组 中 的 位 置 。 这 有 助 于 以 后 调用 Encoder 对 象 ， 但 是 当 只 调用 一 次 时 ， 这 就 没什么 意 
义 。 最 后 对 Encoder 的 调用 必须 将 此 参数 设置 为 tue， 以 清空 其 内 存 ， 释 放 对 象 ， 用 于 垃圾 回收 。 

此 后 使 用 Write0 方 法 向 FileStream 写 入 字 节 数组 就 变 得 非常 简单 : 


aFile.Seek(0, SeekOrigin.Begin); 
aFile.Write(byteData, 0, byteData.Length); 


与 Read0 方 法 一 样 ，Wirite0 方 法 也 有 三 个 参数 ， 包含 要 写 入 文件 流 的 数据 的 字 市 数组 ， 开 始 写 入 的 数组 过 
SARE AFT. 
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操作 字 节 数 组 比较 麻烦 ， 因 为 使 用 FileStream 对 象 非常 困难 ， 那 么 ， 还 有 简单 一 些 的 方法 吗 ? 答案 是 有 的 ， 
因为 有 了 FileStream 对 象 ， 通 单 会 创建 一 个 StreamWriter 或 StreamReader， 并 使 用 它们 的 方法 来 处 理 文件 。 如 
果 不 需 要 将 文件 指针 改变 到 任意 位 置 ， 使 用 这 些 类 束 很 容易 操作 文件 。 

StreamWriter 类 允许 将 字符 和 字符 串 写 入 到 文件 中 ， 它 处 理 撒 层 的 转换 ， 回 FileStream 对 象 写 入 数据 。 

还 可 以 通过 许多 方法 创建 StreamWriter 对 和 象 。 如 果 已 经 有 FileStream 对 象 ， 则 可 以 使 用 此 对 象 来 创建 
StreamWriter XJ 8: 


FileStream aFile - new FileStream("Log.txt", FileMode.CreateNew); 
StreamWriter sw = new StreamWriter (aFile); 


也 可 以 直接 从 文件 中 创建 StreamWriter XJ R: 

StreamWriter sw = new StreamWriter("Log.txt", true); 

IX ie RASEL AAA Boolean 值 ， 这 个 Boolean 值 指定 是 退 加 文件 ， 还 是 创建 新 文件 : 

e ”如果 此 值 设 置 为 false， 则 创建 一 个 新 文件 ， 或 者 截取 现 有 文件 并 打开 它 。 

e ”如果 此 值 设置 为 ttue， 则 打开 文件 ， 保 留 原来 的 数据 。 如 果 找 不 到 文件 ， 则 创建 一 个 新 文件 。 

与 创建 FileStream 对 象 不 同 ， 创 建 StreamWriter 对 象 不 会 提供 一 组 类 似 的 选项 ， 除 了 使 用 Boolean 值 退 加 
文件 或 创建 新 文件 外 ,根本 没有 像 FileStream 类 那样 指定 FileMode 属性 的 选项 。 而 且 ， 没 有 设置 FileAccess 属 
性 的 选项 ， 因 此 总 是 拥有 对 文件 的 读 / 写 权限 。 为 使 用 高 级 参数 ， 必 须 首 先 在 FileStream 构造 图 数 中 指定 这 些 
参数 ， 然 后 在 FileStream 对 象 中 创建 StreamWriter， 如 下 面 的 示例 所 示 。 


试 一 试 ” 将 数据 与 入 输出 流 : StreamWrite\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter20 目录 中 创建 一 个 新 的 控制 人 台 应 用 程序 Stream Write. 
(2) 再 次 使 用 System. IO 名 称 空间 ， 因 此 在 Program.cs 文件 靠近 顶部 的 位 置 添 加 下 面 的 using 指令 : 


using System; 

using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

using System. Threading.Tasks; 
using System. IO; 
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(3) 在 Main(0 方 法 中 添加 下 面 的 代码 : 
static void Main(string[] args) 
{ 
try 
{ 
FileStream aFile = new FileStream("Log.txt", FileMode.OpenOrCreate); 
StreamWriter sw = new StreamWriter (aFile); 
bool truth = true; 
// Write data to file. 
sw.WriteLine ("Hello to you."); 
sw.Write(S"It is now {DateTime.Now.ToLongDateString(}"); 
sw.Write("and things are looking good."); 
sw.Write("More than that,"); 
sw.Write(5" it's {truth} that C# is fun."):; 
sw.Close(); 


} 
catch (IOException e) 
{ 
WriteLine ("An IO exception has been thrown!"); 
WriteLine (e.ToString()); 
ReadLine (); 
return; 


} 
(4) 生成 并 运行 该 项 目 。 如 果 没 有 错误 ， 则 项 目 会 很 快运 行 并 关闭 。 因 为 我 们 在 控制 台 上 没有 显示 任何 内 
容 ， 所 以 在 控制 台中 看 不 到 程序 的 执行 情况 。 
(5) 进入 应 用 程序 目录 ， 找 到 Log.txt 文件 ， 它 位 于 StreamWrite\bin\Debug 文件 夹 中 ， 这 是 因为 我 们 使 用 了 
相对 路 径 。 
(6) 打开 文件 ， 可 以 看 到 图 20-3 所 示 的 文本 。 
司 Log - Notepad 一 口 x 
File Edit Format View Help 
Hello to you. 


It is now Sunday, September 10, 2017 and things are li 
More than that, it's True that C£ is fun. 


€ > 


20-3 


示例 说 明 

这 个 简单 的 应 用 程序 演示 了 StreamWriter 类 的 两 个 最 重要 方法 ， Wite0 和 WriteLine0。 这 两 个 方法 具有 许 
多 重 载 的 版 本 ， 可 以 完成 更 高 级 的 文件 输出 ， 但 本 示例 只 使 用 基本 的 字符 串 输出 。 

WriteLine0 方 法 会 写 入 传递 给 它 的 字符 串 ， 其 后 跟 有 换行 符 。 在 此 示例 中 可 以 看 到 ， 下 一 个 写 入 操作 在 新 
行 上 开始 。 

sw.WriteLine ("Hello to you."); 


Write0 方 法 只 是 把 传 给 它 的 字符 串 写 入 文件 ， 但 不 追加 换行 符 ， 因 此 可 使 用 多 个 Write0 语 句 写 入 完整 的 名 
子 或 段落 。 如 同 可 以 同 控 制 台 写 入 格式 化 数据 一 样 ， 也 可 以 同文 件 写 入 格式 化 数据 。 例 如 ， 可 使 用 标准 格式 化 
参数 把 变量 的 值 写 入 文件 : 


sw.Write(S"It is now {DateTime.Now.ToLongDateString()"); 


DateTime.Now 存储 当前 日 期 ，ToLongDateStrine0 方 法 用 于 将 这 个 日 期 转换 为 便于 读 取 的 格式 。 


sw.Write("More than that,"); 
sw.Write(" it's {truth} that C4 is fun."); 


这 里 也 使 用 了 格式 化 参数 ， 这 次 使 用 Write0 显 示 布尔 值 tuth。 前 面 把 这 个 变量 设置 为 tue， 其 值 会 自动 格 
式 化 ， 转 换 为 字符 串 “True”。 
可 使 用 Write0 和 格式 化 参数 写 入 用 逗号 分 隔 的 文件 : 
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[StreamWriter object] .Write($"{100},{"A nice product"},{10.50}"); 


在 更 复杂 的 示例 中 ， 这 些 数 据 还 可 以 来 目 数 据 库 或 其 他 数据 源 。 


2024 StreamReader 对 象 


输入 流 用 于 从 外 部 源 中 读 取 数据 。 很 多 情况 下 ， 数 据 源 是 磁盘 上 的 文件 或 网 络 的 某 些 位 置 。 任 何 可 以 发 送 
数据 的 位 置 都 可 以 是 数据 源 ， 比 如 网 络 应 用 程序 ， 甚 至 是 控制 台 。 

用 来 从 文件 中 读 取 数据 的 类 是 StreamReader。 与 StreamWriter 一 样 ， 这 是 一 个 通用 类 ， 可 以 用 于 任何 访 。 
下 面 的 示例 会 再 次 围绕 FileStream 对 象 构造 StreamReader 类 ， 使 其 指向 正确 的 文件 。 

StreamReader 对 象 的 创建 方式 与 StreamWriter I RIFE RWM. OEE N E a IA A E H A a GE 
FileStream 对 象 : 


FileStream aFile = new FileStream("Log.txt", FileMode.Open); 
StreamReader sr = new StreamReader (aFile); 


与 StreamWriter 一 样 ， 可 以 直接 用 包含 具体 文件 路 径 的 字符 串 创建 StreamReader 25: 


StreamReader sr = new StreamReader ("Log.txt"); 


试 一 试 ” 从 输入 流 中 读 取 数据 : StreamRead\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter20 目录 中 创建 一 个 新 的 控制 台 应 用 程序 StreamRead。 
(2) SA System.IO 和 System.Console 名 称 空 间 , 因此 将 下 面 的 代码 放 在 Program.cs 文件 的 靠近 项 部 的 
位 置 : 


using System; 
using System.Collections.Generic; 
using System.Linq; 
using System.Text; 
using System. Threading.Tasks; 
using System.IO; 
using static System.Console; 
(3) 在 Main0 方 法 中 添加 下 面 的 代码 : 
static void Main(string[] args) 
{ 
string line; 
try 
{ 
FileStream aFile = new FileStream("Log.txt", FileMode.Open) ; 
StreamReader sr = new StreamReader (aFile); 
line = sr.ReadLine () ; 
// Read data in line by line. 
while(line '- null) 
{ 
WriteLine (line); 
line = sr.ReadLine(); 
} 
sr.Close(); 
} 
catch (IOException e) 


WriteLine ("An IO exception has been thrown!"); 
WriteLine (e.ToString()); 
return; 


} 
ReadKey ()7 
} 
(4) 把 前 面 示例 中 创建 的 Log.txt 文件 复制 到 StreamRead\bin\Debug 目录 中 。 如 果 没 有 Log.txt 文件 , FileStream 
构造 函数 找 不 到 该 文件 ， 束 会 抛 出 异常 。 
(5) 运行 该 应 用 程序 ， 可 以 看 到 写 入 到 控制 台 的 文件 文本 ， 如 图 20-4 所 示 。 
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8 5 C\BeginningCSharp/\Chapter20\StreamRead\ StreamRead\ bin\Debug\StreamRead.exe = O X 


Hel Lo i 


Ma 


示例 说 明 

这 个 应 用 程序 与 前 面 的 应 用 程序 非常 类 似 。 其 明显 区 别 就 是 ， 它 是 在 读 取 数据 ， 而 不 是 写 入 数据 。 与 前 面 
一 样 ， 只 有 导入 SystemJIO 名 称 空间 ， 才 能 访问 需要 的 类 。 

使 用 ReadLine( 方 法 从 文件 中 读 取 文本 。 这 个 方法 读 取 换行 符 之 前 的 文本 , 并 以 字符 串 的 形式 返回 结果 文本 。 
当 到 达 文 件 尾 时 ， 该 方法 就 返回 空 值 ， 通 过 这 种 方法 可 以 测试 文件 是 否 已 到 达 了 尾部 。 注 意 使 用 了 while 循环 ， 
以 便 确保 在 执行 循环 体 的 代码 之 前 读 取 的 行 不 为 空 ， 这 样 就 只 显示 文件 的 有 效 内 容 : 


line = sr.ReadLine(); 
while(line != null) 
{ 

WriteLine (line); 

line = sr.ReadLine(); 


} 


读 取 数据 

ReadLine0 方 法 并 不 是 访问 文件 数据 的 唯一 方法 。StreamReader 类 还 包含 许多 读 取 数据 的 方法 。 

读 取 数据 最 简单 的 方法 是 Read0。 此 方法 将 流 的 下 一 个 字符 作为 正 整数 值 返回 ， 如 果 到 达 了 流 的 结尾 处 ， 
则 返回 - 1。 使 用 Convert 实用 类 可 以 把 这 个 值 转 换 为 字符 。 在 上 面 的 示例 中 ， 可 以 按 如 下 方式 重新 编写 程序 的 
主体 : 

StreamReader sr = new StreamReader (aFile); 

int charCode; 

charCode = sr.Read(); 

while (charCode != -1) 

Write (Convert. ToChar (charCode) ) ; 

charCode = sr.Read(); 

sr.Close(); 

对 于 小 型 文件 ,可 使 用 一 个 非常 简便 的 方法 ReadToEnd0。 此 方法 读 取 整个 文件 ， 并 将 其 作为 字符 串 返 回 。 
在 此 ， 前 面 的 应 用 程序 可 以 何 化 为 : 

StreamReader sr = new StreamReader (aFile); 

line = sr.ReadToEnd () ; 


WriteLine (line); 
sr.Close(): 


ICRAF TE, (AV). RATA BRE REIS TT RA, BEEP SEA EP s MAR 
据 数 据 文 件 的 大 小 茶 止 这 样 处 理 。 如 果 数 据 文 件 非常 大 ， 最 好 将 数据 留 在 文件 中 ， 并 使 用 StreamReader 的 方法 
访问 文件 。 

处 理 大 型 文件 的 另 一 种 方式 是 NET 4 中 引入 的 静态 方法 File.«ReadLines). KERE, File 的 几 个 静态 方法 可 
用 于 简化 文件 数据 的 读 写 ， 但 这 个 方法 特别 有 趣 ， 因 为 它 返 回 IEnumerable<string> 集 合 。 可 以 和 返 代 这 个 集合 
的 字符 串 ， 一 次 读 取 文件 中 的 一 行 。 使 用 这 个 方法 ， 将 前 面 的 示例 重 写 为 : 


foreach (string alternativeLine in File.ReadLines ("Log.txt")) 
WriteLine(alternativeLine); 


可 以 看 出 ,在 .NET 中 ， 可 通过 多 种 不 同 的 方式 获得 相同 的 结果 一 一 读 取 文件 中 的 数据 。 可 以 选择 其 中 最 适 
合 日 己 的 技术 。 
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202.5 异步 文件 访问 


有 时 ， 例 如 要 一 次 性 执行 大 量 文件 访问 操作 ， 或 者 要 处理 非常 大 的 文件 ， 读 写 文件 系统 数据 是 很 缓慢 的 。 
此 时 ， 你 可 能 想 在 等 繁 这 些 操 作 完 成 的 同时 执行 其 他 操作 。 这 对 于 时 面 应 用 程序 尤为 重要 ， 因 为 在 果 面 应 用 程 
序 中 ， 需 要 让 应 用 程序 在 后 台 进 行 处 理 的 同时 ， 对 用 户 保持 良好 的 啊 应 性 。 

为 帮助 实现 这 种 操作 ，.NET 4.5 引入 了 一 些 异 步 方式 来 操作 流 。 这 种 异步 方式 适用 于 FileStream X, thi 
用 于 StreamReader 类 和 StreamWriter 类 。 如 果 查 看 这 些 类 的 定义 ， 可 找到 这 有 Asyne 后 弘 的 方法 ， 例 如 
StreamReader 类 的 ReadLineAsync0 方 法 ， 它 是 ReadLine0 方 法 的 异步 版 本 。 这 些 方 法 在 新 的 基于 任务 的 异步 编 
程 模型 中 使 用 。 

异步 编程 是 一 种 局 级 技术 ， 本 书 中 不 详细 讨论 。 但 是 ， 如 果 你 对 异步 文件 系统 访问 感 兴趣 ， 可 以 把 这 里 介 
绍 的 内 容 作为 起 点 。 更 多 相关 信息 可 以 阅读 由 Christian Nagel 撰写 的 《C# 高 级 编程 (第 11 版 )》。 


20.2.6 ” 读 写 压缩 文件 


在 处 理 文件 时 ， 第 会 占用 大 量 硬盘 空间 。 图 形 和 声音 文件 尤其 如 此 。 读 者 可 能 使 用 过 能 压缩 文件 和 解压 文 
件 的 工具 ， 妆 希望 市 大 文件 到 其 他 地 方 或 者 通过 电子 邮件 把 文件 发 送 给 他 人 人 时， 使 用 这 些 工 具 是 很 方便 的 。 
System.IO.Compression 名 称 空间 就 包含 能 在 代 人 码 中 压 纵 文件 的 类 ， 这 些 类 使 用 GZIP 或 Deflate 算法 ， 这 两 种 算 
法 都 是 会 开 的 、 人 免费 的 ， 任 何人 都 可 以 使 用 。 

但 压缩 文件 并 不 只 是 把 它们 压缩 一 下 就 完事 了 。 商业 应 用 程序 允许 把 多 个 文件 放 在 一 个 压 斩 文 件 (通常 称 为 
存档 文件 ) 中 。System TO.Compression 名 称 空间 中 的 一 些 类 提供 了 类 似 功能 。 但 为 了 简洁 起 见 ， 本 节 介 绍 的 内 容 
要 简单 得 多 : 只 是 把 文本 数据 保存 在 压 盎 文件 中 。 不 能 在 外 部 实用 程序 中 访问 这 个 文件 ， 但 这 个 文件 比 未 压缩 
版 本 要 小 得 多 。 

System.IO.Compression 名 称 空间 中 有 两 个 压缩 流 类 : DeflateStream 和 GZipStream， 它 们 的 工作 方式 非常 类 
似 。 对 于 这 两 个 类 ， 都 要 用 已 有 的 流 初 始 化 它们 ， 对 于 文件 ， 沉 就 是 FileStream 对 象 。 此 后 就 可 以 把 它们 用 于 
StreamReader 和 StreamWriter |, LE ERI. RE. 此外， 只 需要 指定 流 是 用 于 压缩 (保存 文件 ) 还 是 解压 腑 
(加 载 文件 )， 类 融 知 追 要 对 传送 给 它 的 数据 执行 什么 操作 。 这 最 好 用 一 个 示例 来 加 以 说 明 。 


试 一 试 “” 读 写 压 缩 数 据 : Compressor\Program.cs 


(1) 在 C:\BeginningCSharp7\Chapter20 目录 中 创建 一 个 新 的 控制 台 应 用 程序 Compressor. 
(2) 将 下 面 的 代码 放 在 Program.cs 靠近 顶部 的 位 置 . 只 有 导入 System.Console、System.IO 和 System.IO. 
Compression 名 称 空 间 才 能 使 用 文件 和 压缩 类 : 


using System; 

using System.Collections.Generic; 
using System. Ling; 

using System.Text; 

using System. Threading.Tasks; 
using System.IO; 

using System.IO.Compression; 
using static System.Console; 


(3) 把 下 面 的 方法 添加 到 Program.cs 中 Main0 方 法 的 前 面 : 


static void SaveCompressedFile (string filename, string data) 


FileStream fileStream = 

new FileStream(filename, FileMode.Create, FileAccess.Write); 
GZipStream compressionStream = 

new GZipStream(fileStream, CompressionMode.Compress); 
StreamWriter writer = new StreamWriter (compressionStream); 
writer.Write (data); 
writer.Close(); 

} 


static string LoadCompressedFile(string filename) 


FileStream fileStream = 
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new FileStream(filename, FileMode.Open, FileAccess.Read); 
GZipStream compressionStream = 

new GZipStream(fileStream, CompressionMode.Decompress); 
StreamReader reader = new StreamReader (compressionStream) ; 
string data = reader.ReadToEnd (); 
reader.Close(); 
return data; 


| 
(4) 为 Main0 方 法 添加 如 下 代码 : 


static void Main(string[] args) 
{ 
try 
{ 
string filename = "compressedFile.txt"; 
WriteLine ( 
"Enter a string to compress (will be repeated 100 times):"); 
string sourceString = ReadLine(); 
StringBuilder sourceStringMultiplier = 
new StringBuilder (sourcestring.Length * 100); 
for (int i = 0; i « 100; i++) 
{ 
sourceStringMultiplier.Append (sourceString) ; 
} 
sourceString = sourceStringMultiplier.ToString(); 
WriteLine ($"Source data is {sourceString.Length} bytes long."); 
SaveCompressedFile (filename, sourceString) ; 
WriteLine ($"\nData saved to [filename)."); 
FileInfo compressedFileData = new FileéInfo (filename) ; 
Write ($"Compressed file is {compressedFileData.Length}") ; 
WriteLine(" bytes long."); 
string recoveredString = LoadCompressedFile (filename) ; 
recoveredstring = recoveredstring. Substring ( 
0, recoveredString.Length / 100); 
WriteLine ($"\nRecovered data: {recoveredString}",); 
ReadkKey () ; 
) 
catch (IOException ex) 
{ 
WriteLineé ("An IO exception has been thrown!"); 
WriteLine(ex.ToString()): 
ReadkKey () ; 
) 
} 


(5) 运行 该 应 用 程序 ， 输 入 一 个 长 度 合 理 的 长 字符 串 ， 结 果 如 图 20-5 所 示 。 


2pesTted Ito Times 


(6) 在 记事 本 中 打开 compressedFile.txt, ICAU 20-6 所 示 。 


| compressedFile - Notepad n z x 


File Edit Format View Help 
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图 20-6 
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示例 说 明 

这 个 示例 定义 了 两 个 方法 ， 用 于 保存 和 加 载 已 压缩 的 文本 文件 。 第 一 个 方法 是 Save CompressedFileO, 4 
下 所 示 : 

static void SaveCompressedFile (string filename, string data) 

{ 


FileStream fileStream = 
new FileStream(filename, FileMode.Create, FileAccess.Write); 
GZipStream compressionStream = 
new GZipStream(fileStream, CompressionMode.Compress); 
StreamWriter writer = new StreamWriter (compressionStream) ; 
writer.Write (data); 
writer.Close(); 
} 
代码 首先 创建 一 个 FileStream 对 象 , 然后 使 用 它 创 建 一 个 GZapStream X] RR. 注意 , 可 以 用 DeflateStream 
PUK EMS PTA GZipStream 一 一 这 两 个 类 的 工作 方式 相同 。 使 用 CompressionMode.Compress 枚 举 值 指定 
数据 要 进行 压缩 ， 然 后 使 用 StreamWriter 将 数据 写 入 文件 。 
LoadCompressedFile()7774 5; SaveCompressedFile0 方 法 正好 相对 ， 它 不 是 保存 到 文件 名 中 ， 而 是 把 压缩 的 
文件 加 载 到 字符 串 中 : 
static string LoadCompressedFile(string filename) 
{ 
FileStream fileStream = 
new FileStream(filename, FileMode.Open, FileAccess.Read); 
GZipStream compressionStream = 
new GZipStream(fileStream, CompressionMode.Decompress); 
StreamReader reader = new StreamReader (compressionStream) ; 
string data = reader.ReadToEnd(); 
reader.Close(); 


return data; 


} 

其 区 别 很 明显 : 使 用 了 不 同 的 FileMode. FileAccess 和 CompressionMode WSE RIEA ARAB. Tu 
用 StreamReader 从 文件 中 提取 出 未 压缩 的 文本 。 

Main0 中 的 代码 是 这 些 方法 的 一 个 简单 测试 。 它 请 求 一 个 字符 串 ， 将 字符 串 复 制 100 次 ， 再 把 它 压 缩 到 一 
个 文件 中 ， 之 后 检索 它 。 在 本 示例 中 ， 把 《伊利 亚 特 》 第 6 章 的 第 一 句 重 复 100 KA 19 400 个 字符 ， 但 压缩 
后 只 占用 225 SF, HARE XE 80:1。 应 该 承认 ， 这 有 以 偏 概 全 之 嫌 ，GZIP 得 法 很 适合 重复 数据 ， 但 这 里 仅 演 


示 压 缩 过 程 而 已 。 
我 们 还 碍 看 了 存储 在 压缩 文件 中 的 文本 。 显 然 ， 它 的 意义 很 难 明 白 。 在 应 用 程序 之 间 共 享 数据 时 要 考虑 到 


这 一 点 。 但 是 ， 因 为 是 用 已 知 的 算法 压缩 文件 ， 所 以 至 少 能 够 知道 应 用 程序 是 可 以 解压 缩 它 的 。 


20.3 ”监控 文件 系统 


有 时 ， 应 用 程序 所 需要 完成 的 工作 不 仅 限 于 从 文件 系统 中 读 写 文件 。 例 如 ， 知 道 修改 文件 或 目录 的 时 间 非 
弟 重 要 。.NET Framework 允许 方便 地 创建 完成 这 些 任 务 的 定制 应 用 程序 。 

帮助 完成 这 些 任 务 的 类 是 FileSystemWatcher。 这 个 类 提供 了 几 个 应 用 程序 可 以 捕获 的 事件 。 应 用 程序 可 以 
对 文件 系统 事件 作出 啊 应 。 

使 用 FileSystemWatcher 的 基本 过 程 非 常 简单 。 首 先 必 须 设置 一 些 属性 ， 指 定 监控 的 位 置 、 内 容 以 及 引发 应 
用 程序 要 处 理 的 事件 的 时 间 。 然 后 给 FileSystemWatcher 提供 定制 事件 处 理 程序 的 地 址 ， 当 发 生 重要 事件 时 ， 
FileSystemWatcher 就 可 以 调用 这 些 事件 处 理 程序 。 最 后 打开 FileSystemWatcher， 等 竺 事件 。 

在 局 用 FileSystemWatcher 对 象 之 六 必须 设置 的 属性 如 表 20-10 所 示 。 
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3€ 20-10 FileSystemWatcher 的 属性 
属 性 说 AR 
Path 设置 要 监控 的 文件 位 置 或 目录 
这 是 NotifyFilters 枚 举 值 的 组 合 ，NotifyFilters 枚 举 值 指定 了 在 被 监控 的 文件 内 要 监控 哪些 内 容 。 这 些 表示 要 
监控 的 文件 或 文件 夹 的 属性 。 如 果 指 定 的 属性 发 生 了 变化 ， 就 引发 事件 。 可 能 的 枚 举 值 是 Attributes, 


NotifyFilter mn | . : . . - i 
CreationTime、DirectoryName、FileName、LastAccess、LastWrite、Security 和 Size。 注 意 ， 可 通过 二 元 OR 
运算 得 来 合并 这 些 枚 举 值 

Filter 该 过 滤 咒 指定 要 监控 哪些 文件 ， 例 如 ，*.txt 


设置 之 后 ， 就 必须 为 Changed. Created. Deleted 和 Renamed 这 4 个 事件 编写 事件 处 理 程 序 。 如 第 13 章 所 
述 ， 这 需要 创建 自己 的 方法 ， 并 将 方法 由 给 对 象 的 事件 。 将 自己 的 事件 处 理 程序 赋 给 这 些 方法 ， 就 可 以 在 引发 
事件 时 调用 方法 。 当 修改 与 Path、NotifyFilter 和 Filter 属性 匹配 的 文件 或 目录 时 ， 就 引发 每 个 事件 。 

设置 了 属性 和 事件 后 ， 将 EnableRaisingEvents 属性 设置 为 tue， 就 可 以 开始 监控 工作 。 下 例 将 在 一 个 简单 
的 客户 问 应 用 程序 中 使 用 FileSystemWatcher， 来 监控 所 选 的 目录 。 


试 一 试 监控 文件 系统 : FileWatch 


这 是 一 个 较 复 杂 的 示例 ， 使 用 了 本 章 介 绍 的 许多 内 容 。 
(1) f£ C^ BeginningCSharp7\Chapter20 目录 中 创建 一 个 新 的 WPF 应 用 程序 FileWatch. 
(2) 修改 MainWindow.xaml， 如 下 所 示 ( 图 20-7 显示 了 结果 窗口 ): 


«Window x:Class-"FileWatch.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
Title-"File Monitor" Height="160" Width="300"> 
«Grid» 

<Grid.RowDefinitions> 
<RowDefinition Height="Auto" /> 
<RowDefinition Height="Auto" /> 
<RowDefinition /> 
</Grid.RowDefinitions> 
<Grid Margin="4"> 
<Grid.ColumnDefinitions> 
<ColumnDefinition /> 
<ColumnDefinition Width-"Auto" /> 
</Grid.ColumnDefinitions> 
<TextBox Name="LocationBox" TextChanged="LocationBox TextChanged" /> 
<Button Name-"BrowseButton" Grid.Column-"i" Margin="4,0,0,0" 
Content-"Browse..." Click-"BrowseButton Click" /» 
«/Grid» 
«Button Name-"WatchButton" Content-"Watch!" Margin-"4" Grid.Row="1" 
Click-"WatchButton Click" IsEnabled-"False" /> 
<ListBox Name-"WatchOutput" Margin="4" Grid.Row="2" /> 
</Grid> 
</Window> 


Watch 


图 20-7 


(3) 在 MainWindow.xaml.cs 中 添加 下 面 的 using 指令 : 


using System.IO; 
using Microsoft.Win32; 
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(4) 在 MainWindow 类 中 添加 FileSystemWatcher 类 型 的 一 个 字段 : 


namespace FileWatch 
{ 
/// <summary> 
/// Interaction logic for MainWindow.xaml 
/// </summary> 
public partial class MainWindow : Window 
{ 
// File System Watcher object. 
private FileSystemWatcher watcher; 


(5) 在 MainWindow PIII PMMA TE, UAI f£ RTE In] aA s: 


private void AddMessage(string message 
{ 
Dispatcher .BeginInvoke (new Action ( 
() => Watchoutput.Items.Insert( 
0, message)))); 
) 


(6) 在 MainWindow 类 的 构造 函数 的 InitializeComponent0 方 法 调用 之 后 ， 添 加 下 面 的 代码 。 这 段 代 码 用 于 
急 始 化 FileSystemWatcher 对 象 ， 以 及 将 事件 关联 到 AddMessage0 方 法 调用 : 


public MainWindow () 
i 
InitializeComponent (); 
watcher = new FileSystemWatcher(); 
watcher.Deleted += (s, e) => 
AddMessage($"File: (e.FullPath) Deleted"); 
watcher.Renamed += (s, e) => 
AddMessage($"File renamed from {e.OldName} to (e.FullPath)"); 
watcher.Changed += (s, e) => 
AddMessage($"File: {e.FullPath} {e.ChangeType.ToString()}"); 
watcher .Created += (s, e) => 
AddMessage($"File: (e.FullPath) Created"); 
} 


(7) 添加 Browse 按钮 的 Click 事件 处 理 程 序 。 这 个 事件 处 理 程序 中 的 代码 会 打开 Open File 对 话 框 ， 供 用 户 
选择 要 监控 的 文件 : 


private void BrowseButton Click(object sender, RoutedEventArgs e) 
{ 

OpenFileDialog dialog = new OpenFileDialog(); 

if (dialog.ShowDialog(this) == true) 

{ 

LocationBox.Text = dialog. FileName; 

} 

} 


ShowDialog0 方 法 返回 一 个 bool? E, KRHRA PAB File Open 对 话 框 的 方式 (用 户 可 能 单 击 OK 按钮 ， 或 者 
单 击 Cancel 按钮 )。 需 要 确认 用 户 未 单 击 Cancel 按钮 ， 所 以 在 把 用 户 选 择 的 文件 保存 到 TextBox 之 前 ， 将 
ShowDialog0 方 法 调用 的 结果 与 true 进行 比较 。 

(8) 添加 TextBox 的 事件 处 理 程序 TextChanged, 以 确保 当 TextBox 包含 文本 时 ，Watch! 按 钮 处 于 局 用 状态 。 


private void LocationBox TextChanged(object sender, TextChangedEventArgs e) 
{ 

WatchButton.IsEnabled = !string.IsNullOrEmpty (LocationBox.Text) ; 
} 


(9) 将 以 下 代码 添加 到 Watch! 按 钮 的 Click 事件 处 理 程序 ， 这 会 司 动 FileSystemWatcher: 


private void WatchButton Click(object sender, RoutedEventArgs e) 

{ 
watcher.Path = System.I0. Path. GetDirectoryName (LocationBox. Text) ; 
watcher .Filter = System.IO.Path.GetFileName (LocationBox.Text); 
watcher .NotifyFilter = NotifyFilters.LastWrite | 

NotifyFilters.FileName | NotifyFilters.Size; 

AddMessage ("Watching " + LocationBox.Text) ; 
// Begin watching. 
watcher .EnableRaisingEvents = true; 

} 


(10) 创建 目录 CANIempWatch， 在 该 目录 中 创建 文件 temp.txt. 
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(11) 运行 该 应 用 程序 。 如 果 成 功 地 构建 了 所 有 内 容 ， 则 单 击 Browse 按钮 ， 并 选择 C:\TempWatch\temp.txt. 

(12) 单 击 Watch! 按 钮 ， 开 始 监 控 文 件 。 在 应 用 程序 中 可 以 见 到 的 唯一 变化 是 有 一 条 消息 ， 指 出 正在 监控 
文件 。 

(13) 使 用 Windows 资源 管理 器 导航 到 C:\TempWatch. 在 记事 本 中 打开 temp.txt, 并 在 文件 中 添加 一 些 文本 。 
保存 此 文件 。 

(14) 重 命 名 该 文件 。 

(15) 可 以 看 到 对 所 监控 文件 的 变动 说 明 ， 如 图 20-8 所 示 。 

83 File Monitor = Ü & 


C:\TempWatch\ Temp. tt. bet 


File: C:\TempWatch\ lemp.btct. txt Changed 
File: CATempWatchATemp.txt.txt Changed 
Watching C:\TempWatch\ Temp. bet.txt 


示例 说 明 
此 应 用 程序 非常 简单 ， 但 它 演示 了 FileSystemWatcher 的 工作 原理 。 尝 试 在 监控 文本 框 中 输入 不 同 字符 串 。 
如 果 在 目录 中 指定 **， 程 序 就 会 监控 目录 中 的 所 有 变化 。 

应 用 程序 中 的 大 多 数 代 码 都 用 于 设置 FileSystemWatcher 对 象 ， 以 监控 正确 的 位 置 : 
watcher.Path = System.IO.Path.GetDirectoryName (LocationBox.Text); 
watcher.Filter = System.IO.Path.GetFileName (LocationBox.Text); 
watcher .NotifyFilter = NotifyFilters.LastWrite | 

NotifyFilters.FileName | NotifyFilters.Size; 
AddMessage ("Watching ”+ LocationBox.Text); 
// Begin watching. 
watcher.EnableRaisingEvents - true; 


代码 首先 设置 要 监控 的 目录 的 路 径 。 这 使 用 了 到 现在 尚未 介绍 的 一 个 新 对 象 System.IO.Path。 这 是 一 个 裔 
态 关 ， 非 间 类 似 于 静态 对 象 File。 它 给 出 了 许多 前 态 方法 ， 以 处 理 和 提取 文件 位 置 字 符 串 中 的 信息 。 这 里 首先 
使 用 它 通 过 GetDirectoryName0 〇 方法 提取 用 户 在 文本 框 中 输入 的 目录 和 名。 

下 一 行 代码 设置 对 象 的 过 滤器 ， 过 滤器 可 以 是 一 个 实际 文件 ， 表 示 仅 监控 该 文件 。 过 滤器 也 可 以 是 *.txt， 
表示 要 监控 指定 目录 中 的 所 有 .txt 文件 。 我 们 也 可 以 使 用 Path 裔 态 对 象 从 所 提供 的 文件 位 置 中 提取 信息 。 

NotifyFilter 是 NotifyFilters 枚 举 值 的 组 合 ， 指 定 组 成 变化 的 内 容 。 在 此 ， 如 果 最 后 写 入 的 时 间 人 信息、 文件 名 
称 或 文件 大 小 发 生 了 变化 ， 它 就 将 此 变化 通知 应 用 程序 。 更 新 UL 后 ,将 EnableRaisingEvents 属性 设置 为 tue， 开 
始 监控 。 

但 在 此 之 前 ， 还 要 创建 对 象 ， 设 置 事 件 处 理 程序 。 

watcher = new FileSystemWatcher (); 
watcher.Deleted += (5, e) => 
AddMessage($"File: {e.FullPath} Deleted"); 
Watcher.Renamed += (5, e) => 
AddMessage($"File renamed from {e.OldName} to {e.FullPath}"); 
watcher.Changed += (s, e) => 
AddMessage($"File: {e.FullPath} [e.ChangeType.ToString()]"); 


watcher.Created += (5, e) => 
AddMessage($"File: {e.FullPath} Created"); 


这 段 代 码 使 用 了 Lambda 表达 式 来 创建 匿名 事件 处 理 程序 ， 当 删除 、 重 命名 、 修 改 或 创建 文件 时 ， 监 控 器 
对 象 就 触发 事件 , 调用 这 些 事件 处 理 程序 。 这 些 处 理 程序 简单 地 调用 AddMessage() 方 法 来 添加 一 条 消息 。 显 然 ， 
根据 应 用 程序 的 不 同 ， 还 可 以 有 更 复杂 的 响应 。 在 目录 中 添加 文件 时 ， 可 将 其 移 到 别处 ， 或 读 取 其 内 容 ， 引 发 
新 的 进程 。 其 可 能 的 用 法 是 无 穷 无 尽 的 ! 
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20.4 “习题 


(1) 只 有 导入 哪个 名 称 空间 才 人 允许 应 用 程序 使 用 文件 ? 
(2) 何 时 使 用 FileStream 对 象 ， 而 不 是 使 用 StreamWriter 对 象 写 入 文件 ? 

(3) StreamReader 类 的 哪些 方法 允许 从 文件 中 读 取 数据 ， 每 个 方法 的 具体 作用 是 什么 ? 

(4) 哪个 类 可 使 用 Deflate 算法 来 压缩 流 ? 

(5) FileSystemWatcher 类 提供 了 哪些 事件 ， 其 作用 是 什么 ? 

(6) 修改 本 章 构建 的 FileWatch 应 用 程序 ， 使 得 不 必 退 出 应 用 程序 就 可 以 打开 和 关闭 文件 系统 监控 功能 。 
附录 A 给 出 了 习题 答案 。 
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监控 文件 系统 


流 是 序列 化 设备 的 一 种 抽象 表示 ， 可 以 一 次 从 序列 化 设备 中 读 取 或 写 入 一 个 字 节 。 文 件 就 是 这 种 设备 的 一 
个 例子 。 流 有 两 种 类 型 : 输入 和 输出 ， 分 别 用 于 读 取 和 写 入 设备 

NET Framework 中 具有 大 量 抽象 了 文件 系统 访问 的 类 ， 包 括 通过 静态 方法 处 理 文件 和 目录 的 File 和 
Directory， 可 实例 化 为 表示 特定 文件 和 目录 的 FileInfo 和 DirectoryInfo。 后 两 个 类 在 对 文件 和 目录 执行 多 个 
操作 时 使 用 ， 因 为 这 两 个 类 不 要 求 为 每 个 方法 调用 指定 路 径 。 可 在 文件 和 目录 上 执行 的 典型 操作 包括 坦 看 
和 修改 属性 ， 以 及 创建 、 删 除 和 复制 操作 

文件 和 目录 路 径 可 以 是 绝对 的 或 相对 的 。 绝 对 路 径 给 出 了 茶 位 置 的 完整 描述 ， 从 包含 它 的 驱动 器 的 根 目录 
开始 。 所 有 父 目 录 都 与 子 目录 用 反 斜 杠 隔 开 。 相 对 路 径 与 之 类 似 ， 但 从 文件 系统 的 指定 点 开始 ， 例 如 执行 
应 用 程序 的 目录 (工作 目录 )。 浏 览 文件 系统 时 ， 常 使 用 父 目录 的 别名 .. 

FileStream 对 象 允 许 访 问 文件 的 内 容 ， 以 进行 读 写 。 它 以 字 节 为 单位 访问 文件 数据 ， 所 以 并 不 电 是 访问 文件 
数据 的 最 佳 选项 。FileStream 实例 维护 着 文件 内 部 的 一 个 位 置 字 节 索 引 ， 这 样 就 可 以 浏览 文件 的 内 容 了 。 以 
这 种 方式 访问 文件 的 任意 位 置 称 为 随机 访问 

一 种 读 写 文件 数据 的 更 简便 方法 是 使 用 StreamReader 和 StreamWriter 类 ， 以 及 FileStream。 它 们 人 允许 读 写 
字符 和 字符 串 数 据 ， 而 不 是 处 理 字 节 。 这 些 类 型 提供 了 我 们 熟悉 的 处 理 字符 串 的 方法 ， 包 括 ReadLine0 和 
WriteLine0。 因 为 它们 处 理 的 是 字符 串 数 据 ， 所 以 使 用 这 些 类 ， 可 以 更 方便 地 处 理 逗 号 分 隅 的 文件 (这 是 表 
示 结 构 化 数据 的 常见 方式 ) 

可 使 用 DeflateStream 和 GZipStream 压缩 流 类 来 读 写 文件 中 的 压缩 数据 。 这些 类 与 FileStream 一 样 , 也 处 理 
字 节 数据 ， 但 可 以 通过 StreamReader 和 StreamWriter 类 访问 数据 ， 以 简化 代码 

可 使 用 FileSystemWatcher 类 监控 文件 系统 数据 的 变化 。 可 以 监控 文件 和 目录 ， 如 有 必要 ， 还 可 以 提供 一 个 
过 滤器 ， 根 据 需 要 仪 修改 有 特定 扩展 名 的 文件 。FileSystemWatcher 实例 通过 触发 事件 ， 来 通知 我 们 发 生 了 
变化 ， 这 些 事件 可 以 在 代码 中 处 理 


TS 


XML 和 JSON 


本 草 内 容 : 

XML 基础 

JSON 基础 

XML 模式 

XML 文档 对 象 模型 

把 XML 转换 为 JSON 

使 用 XPath 搜索 XML 文档 


本 章 源 代码 下 载 : 

本 章 源 代码 可 以 通过 本 书 合作 站 点 Wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 FR. 下载 代 码 位 于 Chapter21 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 
独 命名 。 


C# 编 程 语言 以 机 器 和 人 类 均 可 读 的 格式 搬 述 了 计算 机 人 逻辑， 而 XML 和 ISON 部 是 数据 语言 ， 以 简单 的 文 
本 格式 存储 数据 ， 这 意味 看 这 些 数据 可 以 被 人 类 和 几乎 任何 计算 机 读 取 。 

大 多 数 C# NET 应 用 程序 都 使 用 XML 以 茶 种 形式 来 存储 数据 ， 如 .config 文件 用 于 存储 配置 细节 ，XAML 
文件 在 WPF 和 Windows Store 应 用 程序 中 使 用 。 因 为 这 个 重要 的 事实 ， 本 章 将 花 最 多 的 时 间 介 绍 XML. Hi 
要 介绍 JSON。 

本 划 将 学 习 XML 和 ISON 的 基础 知识 ， 然 后 学 习 如 何 创建 XML 文档 和 模式 。 你 将 学 习 XmlDocument 类 
的 基本 知识 ， 如 何 读 写 XML， 如 何 插入 和 删除 节点 ， 如 何 将 XML 转换 成 JSON 格式 ， 最 后 学 习 如 何在 XML 
文档 中 使 用 XPath 搜索 数据 。 


21.1 XML 基础 


可 扩展 标记 语言 (Extensible Markup Language，XMIL) 是 一 种 数据 语言 ， 它 将 数据 以 一 种 简单 的 文本 格式 存 
fik, 可 以 被 人 类 和 几乎 任何 计算 机 理解 。 它 是 一 种 W3C 标准 格式 ， 类 似 于 HTML(www.w3.org/XML). Microsoft 
在 NET Framework 和 其 他 微软 产品 中 已 经 完全 采用 它 。. 即 使 是 Microsoft Office 的 新 版 本 引入 的 文档 格式 也 是 基 
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T XML [f], fH Office 应 用 程序 本 号 不 是 .NET 应 用 程序 。 

XML 的 细节 非常 复杂 ， 因 此 在 此 不 介绍 其 所 有 细节 。 幸 好 ， 大 多 数 任务 都 不 需要 了 解 XML 的 详细 知识 ， 
因为 Visual Studio 通常 会 处 理 其 中 大 多 数 工 作 一 一 我 们 基本 上 不 必 手 动 编写 XML 文档 。 如 果 想 更 深入 地 了 解 
XML， 可 以 阅读 Joe Fawcett. Danny Ayers 和 Liam Quin (Wrox, 2012) 编 写 的 Beginning XML， 或 许多 在 线 教程 ， 
如 www.xmlnews.org/docs/xml-basics html 或 http://www.w3schools. com/xml/. 

XML IAEA FAR fai, PBN SHES ABA XML 格式 。 

e vi C# 7«/title- 
<author>Benjamin Perkins et al</author> 


<code>458685</code> 
«/book- 


在 这 个 例子 中 ， 每 本 书 都 有 书 名 、 作 者 和 标识 这 本 书 的 独特 代码 。 每 本 书 的 数据 包含 在 一 个 book 元 素 中 ， 
该 元 素 用 <book> 开 始 标记 开头 ,用 </book> 结 束 标记 结束 。 标题、 作者 和 代码 值 存储 在 book 元 素 的 堪 套 元 素 中 。 

元 素 的 标签 内 也 可 能 有 特性 。 如 果 书 的 代码 是 book 元 素 的 一 个 特性 ， 而 不 是 一 个 元 素 ，book 元 素 的 开头 
可 能 就 是 <book code-458685>。 为 简单 起 见 ， 本 章 的 例子 仅 使 用 元 素 。 特 性 和 元 素 通常 都 称 为 节点 ， 类 似 于 图 
中 的 节点 。 


21.2 JSON 基础 


开发 c# 应 用 程序 时 ， 另 一 门 可 能 遇 到 的 数据 语言 是 JSON。JSON 表示 JavaScript Object Notation. 8k XML 
一 样 ， 它 也 是 一 个 标准 (wwwjson.org)， 尽 官 从 名 字 上 来 看 ， 它 来 源 于 JavaScript 语言 而 非 C#。 虽 然 JSON MR 
XML 一 样 在 整个 NET 中 使 用 ， 但 它 是 传输 Web 服务 和 Web 浏览 器 中 数据 的 一 种 常见 格式 。 

JSON 也 有 一 个 非常 简单 的 格式 。 此 前 用 XML 显示 的 图 书 数据 在 ISON 中 显示 为 : 

("book":[["title":"Beginning Visual c# 2017", 

"author": "Benamin Perkins et al", 
"Code" :"458685"]] 

与 之 前 的 XML 的 示例 一 样 ， 这 里 也 显示 了 书 名 、 作 者 和 唯一 代码 。JSON 使 用 花 括 号 ({ }) 分 隐 数 据 块 ， 使 
用 方 括号 ([]) 界 定数 组 ， 其 方式 与 C#、JavaScript 和 其 他 C 语言 相似 ， 它 们 也 给 代码 块 使 用 花 括 号 ， 给 数组 使 用 
方 括号 。 

JSON 十 一 种 比 XML 更 紧凑 的 格式 ， 但 是 人 们 很 难 阅 读 它 ,特别 是 复杂 数据 中 会 使 用 很 多 伦 括 号 和 括号 进 
THREE. 
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XML 文档 可 以 用 模式 来 搬 述 ， 模式 是 男 一 个 XML 文件 ， 插 述 了 允许 在 一 个 特定 的 文档 中 使 用 的 元 素 和 特 
性 。 可 以 根据 模式 验证 XML 文档 ， 确 保 程序 不 会 遇 到 不 打算 处 理 的 数据 。 用 于 C# 的 标准 模式 XML 格式 是 
XSD(XML Schema Definition). 

图 21-1 包含 了 Visual Studio 能 够 识别 的 模式 的 一 个 长 列表 (从 Visual Studio 36. 363€ XML | Schemas. .., 
可 以 看 到 该 列表 )， 但 它 不 会 自动 记忆 已 使 用 过 的 模式 。 如 果 经 常 使 用 某 个 模式 ， 但 不 想 在 每 次 需要 时 浏览 找到 
该 模式 ， 束 可 以 把 该 模式 复制 到 以 下 位 置 : C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\ 
Xml\Schemas。 复 制 到 该 位 置 的 任何 模式 部 会 显示 在 XML Schemas 对 话 框 中 。 
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AML Schemas 


Edit your current XML schema set 


XML Schemas used in a schema set provide validation and intellisense in the XML Editor. 
Select the desired schema usage with the Use’ column dropdown list. 


Use Target Namespace à File Name Location H | Add... | 


T GhostStories.xsd CABegVCSha rp\Ch | 


DotNetConfig.xsd CAProgram Files [x 
http: //microsoft.com/schemas/VisualStudio/TeamTest/2010 vstst.xsd CAProgram Files (x€ 


http. //schemas.microsoft.com/ado/2006/04 /codegeneration System.Data.Resources.CodeGenerationSchema.xsd C:\Program Files (x£ 


http://schemas.microsoft.com/ado/2006/04 /edm System. Data. Resources CSDL Schema 1.xsd C:\Program Files [x 


http://schemas.microsoft.com/ado/2006/04 /edm/providermanif est System.Data.Resources.ProviderServices.ProviderManifest.xsd | C:\Program Files (x 


http://schemas.microsoft.com/ado/2006/04 /e dm/s sdl 5ystem.Data.Resaurces.5SDI Schema.xs d C:\Program Files [xz 


| htto://schemas.microsoft.com/ado/2007/05/edm — | 5ystem.Data.Resources.CSDLSchema 1 1.xsd CAProaram Files t£ ~ 
L 


fl 


21-1 


可 以 从 XML 文件 中 创建 XML 模式 ， 使 用 该 模式 来 验证 其 他 变化 ， 如 下 面 的 示例 所 示 。 


试 一 试 f£ Visual Studio 中 创建 XML 文档 : Chapter21\XML and Schema\GhostStories.xml 


按照 下 面 的 步骤 来 创建 XML 文档 。 

(1) 打开 Visual Studio， 从 菜单 中 选择 File | New | File。 如 果 没 有 看 到 这 个 选项 ， 请 创建 一 个 新 项 目 。 在 
Solution Explorer 中 右 击 项 目 ， 选 拌 添加 一 个 新 项 。 然 后 从 对 话 框 中 选择 XML File. 

(2) 在 New File 对 话 杠 中， 选择 XML File， 单 击 Open. Visual Studio 会 自动 创建 一 个 新 的 XML 文档。 如 
图 21-1 所 示 ，Visual Studio 添加 了 XML 声明 ， 以 encoding 特性 结束 (其 特性 和 元 素 也 是 彩色 的 ， 但 在 黑白 纸张 
中 看 不 到 这 种 效果 )。 

(3) 按 下 Cabs 组 合 键 ， 或 者 在 菜单 中 选择 File | Save XMLFilel xml， 保 存 文件 。Visual Studio 会 询问 文件 
的 保存 位 置 ， 以 及 文件 的 名 称 。 将 其 保存 在 BeginningCSharp7\Chapter21\XML and Schemas 文件 夹 中 ， 命 名 为 
GhostStories.xml. 

(4) 将 光标 移 到 XML 声明 下 面 的 代码 行 ， 输 入 文本 <stories>。 注 意 ， 输 入 大 于 号 关闭 开始 标记 时 ，Visual 
Studio 会 目 动 置 入 结束 标记 。 

(5) "i A FIBI] XML 文件 ， 单 击 Save 按钮 : 


«stories» 
«story» 
<title>A House in Aungier Street</title> 
<author> 
<name>Sheridan Le Fanu</name> 
<nationality>Irish</nationality> 
</author> 
<rating>eerie</rating> 
</story> 
<story> 
<title>The Signalman</title> 
<author> 
<name>Charles Dickens</name> 
<nationality>English</nationality> 
</author> 
<rating>atmospheric</rating> 
</story> 
<story> 
<title>The Turn of the Screw</title> 
<author> 
<name>Henry James</name> 
<nationality>American</nationality> 
«/author- 
«rating»a bit dull</rating> 
</story> 
</stories> 


(6) 现在 可 以 让 Visual Studio 为 刚才 编写 的 XML 文件 创建 相应 的 模式 。 为 此 ， 从 XML 菜单 中 选择 Create 
Schema 菜单 项 ， 单 击 Save as GhostStories.xsd， 保 存 得 到 的 XSD 文件 。 
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(7) 返回 到 XML 文件 ， 在 结束 标记 < /stories > 之 前 输入 如 下 XML: 
<story> 
<title>Number 13</title> 
<author> 
<name>M.R. James</name> 
<nationality>English</nationality> 
</author> 
<rating>mysterious</rating> 
</story> 


注意 ， 开 始 输入 开始 标记 时 ， 会 显示 IntelliSense 提示 。 这 是 因为 Visual Studio 知道 把 新 建 的 XSD 模式 连 
接 到 正在 输入 的 XML 文件 上 。 

(8) 可 在 Visual Studio 中 创建 XML 和 一 个 或 多 个 模式 之 间 的 链接 。 选 择 XML | Schemas， 会 打开 如 图 21-2 
所 示 的 对 话 框 。 在 Visual Studio 可 识别 的 长 模式 列表 的 项 部 ， 会 看 到 GhostStories.xsd。 它 的 左边 是 一 个 复 选 标 
记 ， 表 示 这 个 模式 用 于 当前 的 XML 文档 。 


XMLFilei.xml + X 


?xml version-"1.6" encoding-"utf-8"?» — 


PRU 


图 21-2 
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XML 文档 对 象 模型 (Document Object Model, DOMD) 是 一 组 以 非常 直观 的 方式 访问 和 处 理 XML 的 类 。 DOM 
不 是 读 取 XML 数据 的 最 快捷 方式 ， 但 只 要 理解 了 类 和 XML 文档 中 元 素 之 间 的 关系 ，DOM 就 很 容易 使 用 。 

构成 DOM 的 类 在 名 称 空间 System.Xml 中 。 在 这 个 名 称 空间 中 有 几 个 类 和 子 名 称 空间 。 但 本 章 只 介绍 几 个 
便于 操作 XML 的 类 。 这 些 类 如 表 21-1 所 示 。 


表 21-1 BAR DOM 类 


类 名 说 明 
| 这 个 类 表示 文档 树 中 的 一 个 节点 ， 它 是 本 章 许 多 类 的 基 类 。 如 果 这 个 节 扣 表示 XML 文档 的 根 ,就 可 以 从 它 
导航 到 文档 的 任意 位 置 
扩展 了 XmlNode 类 ， 但 通常 是 使 用 XML 的 第 一 个 对 象 ， 因 为 这 个 类 用 于 加 载 磁盘 或 其 他 地 方 的 数据 并 
XmlDocument 
在 这 些 位 置 保存 数据 
XmlElement 表示 XML 文档 中 的 一 个 元 素 。XmlFElement 派生 于 XmlLinkedNode, XmlLinkedNode 派生 于 XmlNode 
XmlAttribute 表示 一 个 特性 ， 与 XmlDocument 类 一 样 ， 它 也 派生 于 XmlNode 类 
XmlText 表示 开始 标记 和 结束 标记 之 间 的 文本 
XmlComment 表示 一 种 特殊 类 型 的 节点 ， 这 种 节操 不 是 文档 的 一 部 分 ， 但 为 阅读 器 提供 文档 各 部 分 的 信息 
XmlNodeList 表示 一 个 节点 集合 


21.4.1 XmlDocument 类 


HH, BAHE XML 的 应 用 程序 ， 首 先 应 从 磁盘 中 读 取 它 。 如 表 21-1 所 示 ， 这 是 XmlDocument 类 的 工作 。 
可 将 XmlDocument 看 成 磁盘 上 文件 的 内 存 表示 。 使 用 XmlDocument 类 把 文件 加 载 到 内 存 后 ， 就 可 以 从 中 获得 
文档 的 根 节 点 ， 开 始 读 取 和 处 理 XML J: 


using System.Xml; 


XmlDocument document = new XmlDocument (); 
document.Load(@"C:\BeginningCSharp7\Chapter21\XML and Schema\books.xml"); 
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这 两 行 代码 创建 了 XmlDocument 类 的 一 个 新 实例 ， 并 在 其 中 加 载 books.xml 文件 。 


注意 : 
文件 夹 名 是 一 个 绝对 路 径 ， 文 件 夹 结 构 可 以 不 同 ， 此 时 ， 应 调整 documentLoad 中 的 路 径 ， 以 反映 计算 机 
中 实际 的 文件 夹 路 径 。 


XmlDocument 类 位 于 System.Xml 名 称 空间 中 ,所 以 应 在 代码 开头 的 using 部 分 插入 using System.Xml: 语 句 。 

除了 加 载 和 保存 XML 外 ，XmlDocument 类 还 负责 维护 XML 结构 。 所 以 ， 这 个 类 有 许多 方法 可 以 用 于 创 
建 、 修 改 和 删除 树 中 的 节点 。 稍 后 将 介绍 其 中 一 些 方法 ， 但 为 了 正确 理解 这 些 方法 ， 还 需要 了 解 另 一 个 类 ; 
XmlElement. 


21.4.2 XmlElement 类 


文档 加 载 到 内 存 后 ， 就 要 对 它 执 行 一 些 操 作 。 上 和 面 代码 创建 的 义 mlDocument 实例 的 DocumentElement 属性 
会 返回 一 个 XmlElement 实例 (表示 XmlDocument 的 根 节 点 )。 这 个 元 率 非 党 重要， 因为 有 了 和 它 ， 就 可 以 访问 文档 
中 的 所 有 信息 。 


xmlDocument document = new XmlDocument (); 
document. Load (@"C:\BeginningCSharp7\Chapter21\ 
XML and Schema\books.xml"); 

XmlElement element = document. DocumentElement; 


获得 文档 的 根 节点 后 ， 就 可 以 使 用 信息 了 。XmlElement 类 包含 的 方法 和 属性 可 以 处 开 
面 衣 先 看 看 用 于 导航 XML 元 素 的 属性 ， 如 表 21-2 所 示 。 


! 树 的 节点 和 特性 。 下 


表 21-2 XmlElement 的 属性 
m 性 说 明 
该 属性 返回 当前 节点 之 后 的 第 一 个 子 节点 。 在 本 章 前 面 的 booksxml SF, MARRET AE books, {R 
节点 之 后 的 节点 是 book， 在 该 文档 中 ， 根 节点 books 的 第 一 个 子 节 点 是 book. 


ie <books> Root node 
FirstChild «book- FirstChild 


FirstChild 返回 一 个 XmlNode 对 象 ， 应 测试 返回 节点 的 类 型 ， 因 为 它 不 总 是 一 个 XmlElement 实例 。 在 
books 示例 中 ，Title 元 素 的 子 元 素 是 表示 文本 Beginning Visual C# 的 XmlText TA 

该 属性 的 操作 与 FirstChild 属性 十 分 类 似 ， 但 返回 当前 节操 的 最 后 一 个 子 节 扣 。 在 books 示例 中 ，books 
节点 的 最 后 一 个 子 节点 仍 是 book， 但 它 表示 "Beginning XML" book. 


<books> Root node 
«book» FirstChild 
<title>Beginning Visual C4 2017</title> 

| UR <author>Benjamin Perkins et al</author> 
LastChild <code>458685</code> 

</book> 

«book» Lastchild 

«title»Beginning XML</title> 

<author>Joe Fawcett et al</author> 


<code>162132</code> 
</book> 
</books> 
ParentNode 该 属性 返回 当前 节点 的 父 节 点 。 在 books AHH, books 节点 是 book 节点 的 父 节点 
FirstChild 和 LastChild 属性 返回 当前 节点 的 叶子 节点 ， 而 NextSibling 节点 返回 有 相同 父 节点 的 下 一 个 节 
NextSibling Fic TE books 示例 中 ，title 元 素 的 NextSibling 属性 返回 author 元 素 ， 在 author 元 素 上 调用 NextSibling, 
会 返回 code TUK 


HasChildNodes 检查 当前 元 素 是 否 有 子 元 素 ， 而 不 必 获 取 FirstChild 的 值 并 检查 它 是 否 为 null 
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使 用 表 21-2 中 的 5 个 属性 ， 可 以 遍历 整个 XmlDocument， 如 下 和 面 的 示例 所 示 。 
iti, AIE XML 文档 中 的 所 有 节点 : 


Chapter21\Loop ThroughXm|Document\MainWindows.xaml.cs 


在 这 个 示例 中 ， 要 创建 一 个 小 型 WPF MBIEUT, E XML APARATS. FTE CRIA, WR 
是 XmlText 元 紊 ， 就 打印 出 包含 在 元 又 中 的 文本 。 这 上段 代码 使 用 了 Books.xml， 如 21.3 市 “XML 模式 ”所 述 。 
如 果 没 有 创建 这 个 文件 ， 可 在 本 书 的 下 载 代 码 中 找到 它 (Chapter21\XML and Schemas\)。 

(1) 首先 创建 一 个 新 的 WPF 项 目 ， 方 法 是 选择 File | New | Project 菜单 项 ， 在 打开 的 对 话 框 中 选择 Visual C£ | 
WPF App (CNET Framework)。 将 项 目 合 名 为 LoopThroughXmlDocument， 按 下 回 车 键 。 

(2) 将 一 个 TextBlock 和 一 个 Button 控件 拖 放 到 窗 体 上 ， 按 照 图 21-3 所 示 设 计 窗 体 。 


图 21-3 


(3) 将 TextBlock 控件 命名 为 textBlockResults， 按 钮 命名 为 buttonLoop。 人 允许 TextBlock 填 满 按钮 没有 使 用 
的 全 部 空间 。 
(4) 为 按钮 的 单 击 事件 添加 事件 处 理 程序 ， 输 入 下 面 的 代码 。 注 意 ， 要 在 文件 顶部 的 using 部 分 添加 using 
System.Xml: 语 句 : 
private void buttonLoop Click(object sender, RoutedEventArgs e) 
xmlDocument document = new XmlDocument (); 


document . Load (booksF1ile);} 
textBlockResults.Text = 


FormatText (document.DocumentElement as XmlNode, "", ""); 
} 
private string FormatText(XmlNode node, string text, string indent) 
{ 
if (node is XmlText) 
{ 


text += node.Value; 
return text; 

} 

if (string.IsNullOrEmpty (indent) ) 
indent = ""; 

else 

{ 


text += "\r\n" + indent; 


if (node is XmlComment) 

{ 
text += node.OuterXml; 
return text; 

} 

text += "cz" + node.Name; 

if (node.Attributes.Count > 0) 


AddAttributes (node, ref text); 
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} 
if (node.HasChildNodes) 
{ 
text += ">"; 
foreach (XmlNode child in node.ChildNodes) 


{ 

text = FormatText (child, text, indent + " "); 
} 
if (node.ChildNodes.Count == 1 && 


(node.FirstChild is XmlText || node.FirstChild is XmlComment)) 
text += "z/" + node.Name + ">"; 
else 
text += "\r\n" + indent + "</" + node.Name + ">"; 
} 
else 
text += " /»"; 
return text; 
} 
private void AddAttributes(XmlNode node, ref string text) 
{ 
foreach (XmlAttribute xa in node.Attributes) 
{ 


text += " " + xa.Name + "="" 4 xa.Value + "'"; 


} 


(5) 添加 一 个 私有 常量 ， 用 于 保存 所 加 载 文 件 的 位 置 。 需 要 把 这 个 常量 的 值 改 为 本 地 系统 中 存储 文件 的 
位 置 : 


private const string booksFile = 
@"Cc:\BeginningCSharp7\Chapter21\XML and SchemaMBooks.xml"; 


(6) 运行 该 应 用 程序 ， 单 击 Loop 按钮 。 结 果 如 图 21-4 Brzs 


<books> 

=book> 
<title>Beginning Visual C$ 2015«/title» 
<author=Benamin Perkins et al</author 
<code>096689</code> 

</book> 

«book» 
<title>Professional C# 5.0«/title» 
<author>Christian Nagel et al</author 
xcode28323032«/code- 


</book> 
</books> 


21-4 


示例 说 明 

单 击 按钮 时 ， 会 调用 XmlDocument 方 法 Load。 这 个 方法 把 文件 中 的 XML 加 载 到 XmlDocument 实 例 中 ， 
XmlDocument 实 例 用 于 访问 XML 的 元 隶 。 接 者 调用 一 个 方法 来 递归 和 闪 代 XML， 并 把 XML 文档 的 根 节 点 传送 给 方 
法 。 根 元 素 是 使 用 XmlDocument 类 的 属性 DocumentElement 获 得 的 。 除 了 在 传送 给 FormatText 方 法 的 根 参 数 上 检 
得 null 外 ， 还 要 注意 让 语句 : 

if = is XmlText) 

} 

is 运算 符 可 以 检查 对 象 的 类 型 ， 如 果实 例 是 指定 的 类 型 ， 就 返回 true。 即 使 根 节 点 声明 为 XmlINode， 这 也 只 
是 要 操作 的 对 象 的 基本 类 型 。 使 用 is 运 复 符 可 在 运行 期 间 确 定 对 象 类 型 ， 并 根据 该 类 型 选择 要 执行 的 操作 。 

在 FormatText 方法 中 给 文本 框 生成 文本 。 注 意 必 须知 道 根 节点 的 当前 实例 的 闫 型， 因为 要 显示 的 信息 的 获 
取 方 式 对 于 不 同 的 元 对 来 说 是 不 同 的 。 我 们 要 显示 XmlElements 的 名 称 和 XmlText 元 系 的 值 。 
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21.4.3 ÁTT AA 


在 了 解 如 何 改变 节点 值 之 前 ， 先 要 明白， 节点 值 一 般 比 较 复杂 。 实 际 上 ， 即 使 派生 于 XmlNode 的 所 有 类 都 
包含 Value 属性 ， 它 也 很 少 返 回 有 用 的 信息 。 初 看 起 来 它 可 能 令 人 失望 ， 但 实际 上 是 十 分 合理 的 。 分 析 一 下 前 
面 的 books 示例 : 

<books> 

<book> 
<title>Beginning Visual C# 2017</title> 
<author>Benjamin Perkins et al</author> 
<code>458685</code> 

</book> 


<book> 
</books> 


文档 中 的 每 对 标记 都 解析 为 DOM. 中 的 一 个 节点 。 在 迁 代 文档 中 的 所 有 节点 时 ， 会 遇 到 许多 XmlElement 
节点 和 三 个 XmlText WA. EÈ XML 中 的 XmlElement 节点 是 <books>、<book>>、<title>、<author> 和 <code>。 
XmlText “i Sze title, author 和 code 开始 标记 和 结束 标记 之 间 的 文本 。 也 可 以 说 title; author 和 code 的 值 是 标 
记 之 则 的 文本 ， 但 文本 本 身 就 是 一 个 节点 ， 是 这 个 市 扣 实 际 包含 了 值 。 其 他 标记 都 没有 相关 的 值 。 

在 上 述 FormatText 方法 的 代码 靠近 顶部 的 位 置 ， 站 块 中 的 下 述 代码 在 当前 节点 是 XmlText 时 执行 


text += node.Value; 


XmlText 节点 实例 的 Value 属性 用 于 获取 节点 的 值 。 

如 果 使 用 XmlElement 类 型 的 节点 的 Value 属性 ， 就 返回 null， 但 如 果 使 用 另 两 个 方法 InnerText 和 InnerXml 
中 的 一 个 ， 就 可 以 获取 XmlElement 开始 标记 和 结束 标记 之 间 的 信息 。 也 就 是 说 ， 可 以 使 用 两 个 方法 和 一 个 属 
性 来 操作 节点 的 值 ， 如 表 21-3 所 示 。 


表 21-3 获取 节点 值 的 三 种 方法 
属 性 说 明 
这 个 属性 获取 当前 节点 中 所 有 子 节点 的 文本 ， 把 它 作为 一 个 串联 字符 串 返 回 。 也 就 是 说 ， 在 上 面 的 XML 
H, 如 果 获 取 book 节点 的 InnerText 值 , 就 返回 字符 串 Beginning Visual C£ 2017#Benjamin Perkins et al458685. 


und 如 果 获取 title 节点 的 TanerText， 就 只 返回 "Beginning Visual Cf 2017"。 可 以 使 用 这 个 方法 设置 文本 ， 但 要 小 
心 ， 因 为 如 果 设 置 了 错误 节点 的 文本 ， 就 很 可 能 会 改写 不 想 改 变 的 信息 
InnerXml 属性 返回 类 似 于 InnerText 的 文本 ,但 它 也 返回 所 有 标记 。 因 此 ， 如 果 获 取 book 节点 上 的 InnerXml 
值 ， 结 果 是 如 下 字符 串 : 
ined ee Perkins et al 
可 以 看 出 ， 如 果 字 符 串 包含 要 直接 插入 XML 文档 的 内 容 ， 这 是 很 有 用 的 。 但 是 要 对 该 字符 串 负 全 责 ， 如 果 
插入 格式 错误 的 XML， 应 用 程序 就 会 产生 异常 
Value 属性 是 操作 文档 中 信息 的 最 精练 方式 ， 但 如 前 所 述 ， 在 获取 值 时 ， 只 有 几 个 类 会 返回 有 用 的 信息 。 返 
回 所 需 文本 的 类 如 下 所 示 : 
Value 
xmlText 
xmlComment 
xmlAttribute 


1. 插入 新 节点 

了 解 了 如 何 遍 历 XML 文档 ， 如 何 获取 元 素 的 值 后 ， 下 面 学 习 如 何 给 前 面 使 用 的 books 文档 添加 节点 ， 改 
变 文 档 的 结构 。 

要 在 列表 中 插入 新 元 素 ， 需 要 使 用 XmlDocument 和 XmlNode 类 中 的 新 方法 ， 如 表 21-4 所 示 。 可 使 用 
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XmlDocument 类 的 方法 创建 新 的 XmlNode 和 XmlElement 实例 ,这 非常 不 错 ， 因 为 这 两 个 类 都 只 有 一 个 受 保护 
的 构造 函数 ， 不 能 直接 使 用 new 创建 它们 的 实例 。 


表 21-4 用 于 创建 节点 的 方法 
方 法 说 明 
创建 任意 类 型 的 节点 。 该 方法 有 三 个 重 载 版 本 ,其 中 两 个 允许 创建 XmlINodeType 枚 举 中 所 列 出 的 类 型 
的 节点 ， 另 一 个 允许 把 要 使 用 的 节点 类 型 指定 为 字符 串 。 除 非 对 指定 的 不 是 枚 举 中 的 节点 类 型 有 十 足 


— 的 把 握 ， 否 则 强烈 推荐 使 用 枚 举 的 两 个 重 载 版 本 。 该 方法 返回 一 个 XmlNode 实例 ， 该 实例 可 以 显 式 地 
转换 为 合适 的 类 型 

CreateElement 这 只 是 CreateNode 的 一 个 版 本 ， 只 能 创建 XmlElements 类 型 的 节操 

CreateAttribute 这 也 只 是 CreateNode 的 一 个 版 本 ， 只 能 创建 XmlAttribute 类 型 的 节点 

CreateTextNode 创建 XmlTextNode 类 型 的 节点 

在 这 个 列表 中 包含 这 个 方法 , 是 为 了 说 明 可 以 创建 的 节点 类 型 的 多 样 性 。 该 方法 并 不 创建 由 XML 文档 
表示 的 数据 节点 ， 而 是 创建 注释 ， 以 便 人 们 读 取 数 据 。 在 应 用 程序 中 读 取 文 档 时 ， 束 可 以 读 取 注释 

表 21-4 中 的 方法 都 用 于 创建 节点 ， 在 调用 其 中 一 个 方法 后 ， 就 必须 执行 一 些 操 作 。 在 创建 节点 后 ， 节 点 并 


未 包含 其 他 信息 ,节点 也 没有 插入 文档 中 .为 此 ,应 使 用 派生 于 XmlNode 的 类 (包括 XmlDocument 和 XmlElement) 
中 的 方法 。 表 21-5 描述 了 这 些 方法 。 


表 21-5 用 于 插入 节点 的 方法 


方 法 说 明 

把 一 个 子 节点 人 奶 加 到 XmlNode 类 型 或 其 派生 类 型 的 节点 上 。 在 调用 该 方法 后 ， 奶 加 的 节点 显示 在 相应 

AppendChild PRAT RAR se. MRAAOTH AAI, PRE, AWRY RR, MM 
按 正 确 顺 序 仍 加 节点 

— 使 用 InsertAfter 方法 ， 可 以 控制 插入 新 节点 的 位 置 。 该 方法 带 有 两 个 参数 ， 第 一 个 是 新 市 点 ， 第 二 个 是 
在 其 后 插入 新 节点 的 节点 

InsertBefore 这 个 方法 与 InsertAfter 类 似 ， 但 新 节点 插 到 参考 节点 之 前 

下 面 的 示例 以 前 面 的 示例 为 基础 ， 在 books.xml 文档 中 插入 一 个 book zi. HAN ACA BU) H TH EES 


的 代码 ， 所 以 如 果 该 示例 运行 几 次 ， 文 档 中 可 能 融会 包含 许多 相同 的 节点 。 


试 一 试 ” 创 建 节点 : Chapter21\LoopThroughXmlDocument\MainWindow.xaml.cs 
本 例 以 前 面 创 建 的 LoopThroughXmlDocument 项 目 为 基础 。 按 照 下 面 的 步骤 给 books.xml 文档 添加 一 个 


(1) 将 TextBlock 放 在 一 个 ScrollViewer 中 ， 将 其 VerticalScrollBarVisibility 属性 设 为 Auto. 

(2) 在 窗 体 的 已 有 按钮 下 面 添加 一 个 按钮 ， 命 名 为 buttonCreateNode。 将 其 Content 属性 改 为 Create. 
(3) 为 新 按钮 添加 单 击 事件 的 处 理 程 序 ， 和 输入 下 面 的 代码 : 

private void buttonCreateNode Click(object sender, RoutedEventArgs e) 


// Load the XML document. 

XmlDocument document = new XmlDocument (); 
document. Load (booksFile); 

// Get the root element. 

XmlElement root = document.DocumentElement; 

// Create the new nodes. 

XmlElement newBook = document.CreateElement ("book"); 
XmlElement newTitle = document.CreateElement ("title"); 
XmlElement newAuthor = document.CreateElement ("author"); 
xmlElement newCode = document.CreateElement ("code"); 
xmlText title = document.CreateTextNode ("Beginning Visual C# 2015"); 
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xmlText author = document.CreateTextNode ("Karli Watson et al"); 
XmlText code = document.CreateTextNode ("314418"); 

XmlComment comment = document.CreateComment ("The previous edition"); 
// Insert the elements. 

newBook.Appendchild (comment); 

newBook.AppendChild (newTitle); 

newBook.Appendchild (newAuthor); 

newBook.AppendChild (newCode) ; 

newTitle.Appendchild(title); 

newAuthor.AppendChild (author); 

newCode.AppendcChild (code); 

root.InsertAfter(newBook, root.LastChild); 
document .Save (booksFile); 


} 
(4) 运行 该 应 用 程序 ， 单 击 Create 按钮 。 再 单 击 Loop 按钮 ， 对 话 框 如 图 21-5 所 示 。 


<books> 

=book> 
«title»Beginning Visual C$ 2015«/title» 
<author=Benamin Perkins et al</author 
ecode»096689«/code» 

«book» 

«book 
title» Professional Cit 5,0</tithe> 
«authorzChristian Nagel et al&/authorz 
<=code>$33037</code> 

</book> 


*book» 
<!_The previous edition— 
<title>Beginning Visual C# 2012«/title» 
«author» Karli Watson et al«/author» 
<code>314418</code> 

</book> 


</books> 


图 21-5 


在 上 面 的 示例 中 没有 创建 一 个 重要 类 型 的 市 点 :XmlAttibute， 这 里 把 它 留 作 本 章 的 练习 。 


示例 说 明 
buttonCreateNode Click 方法 中 的 代码 创建 了 所 有 节点 。 它 创建 了 8 个 新 节点 ， 其 中 4 个 节点 的 类 型 是 


XmlElement, 3 个 节点 的 类 型 是 XmlText，1 个 节点 的 类 型 是 XmlComment. 
所 有 节点 都 是 用 封装 XmlDocument 实例 的 方法 创建 的 。XmlElement 节点 是 用 CreateElement 方法 创建 的 ， 
XmlText i Æ CreateTextNode 方法 创建 的 ，XmlComment 节点 是 用 CreateComment 方法 创建 的 。 
创建 完 节 点 后 ， 还 需要 把 它们 插入 XML firn. eA CAR EH AppendChild 方法 实现 的 ， 新 节点 将 成 
为 该 元 素 的 一 个 子 节 点 。 唯 一 的 例外 是 book 节点 , 它 是 所 有 新 节点 的 根 节 点 。 这 个 节点 使 用 根 对 象 的 InsertAfter 
方法 插入 树 中 。 使 用 AppendChild 方法 插入 的 所 有 节点 总 是 成 为 子 节 点 列表 的 最 后 一 项 ， 而 InsertAfter 允许 指 
ET ARME- 


2. 删除 节点 


学 习 了 如 何 创建 新 节点 后 ， 剩 下 的 就 是 如 何 删 除 节 点 了。 派生 于 XmlNode 的 所 有 类 都 包含 允许 从 文档 中 删 
除 节点 的 两 个 方法 ， 如 表 21-6 所 示 。 


表 21-6 用 于 删除 节点 的 方法 


方 法 说 PA 
" 有 这 个 方法 删除 节点 上 的 所 有 子 节点 。 不 太 明 显 的 是 ， 它 还 会 删除 节点 上 的 所 有 特性 ， 因 为 它们 也 被 看 成 子 
EMmover 
TR 


RemoveChild 这 个 方法 删除 节 把 上 的 一 个 子 节 后 ， 返 回 从 文档 中 删除 的 节点 。 如 果 改 变 主意 ， 还 可 以 把 它 重 新 插 回 文档 
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下 面 的 示例 将 扩展 前 面 两 个 示例 创建 的 应 用 程序 , 使 其 包含 删除 节点 的 功能 。 只 十 要 找 出 book ANA 
一 个 实例 ， 并 删除 它 。 


试 一 试 ”删除 节点 : Chapter21\LoopThroughXmlDocument\MainWindow.xaml.cs 


本 例 以 前 面 创建 的 LoopThroughXmlDocument 项 目 为 基础 。 下 面 的 步骤 将 找 出 book 市 点 的 最 后 一 个 实例 ， 
并 删除 它 。 

(1) 在 前 面 两 个 已 有 的 按钮 下 面 添 加 一 个 新 按钮 ， 命 名 为 buttonDeleteNode， 将 其 Content 属性 设置 为 
Delete. 

(2) 双击 这 个 新 按钮 ， 输 入 下 面 的 代码 : 

private void buttonDeleteNode Click(object sender, RoutedEventArgs e) 


// Load the XML document. 
xmlDocument document = new XmlDocument (); 
document. Load (booksFile); 
// Get the root element. 
XmlElement root = document.DocumentElement; 
// Find the node. root is the «books» tag, so its last child 
// which will be the last «book» node. 
if (root.HasChildNodes) 
{ 
xmlNode book = root.LastChild; 
// Delete the child. 
root .RemoveChild (book); 
// Save the document back to disk. 
document.Save (booksFile); 


} 
} 
(3) 运行 该 应 用 程序 。 单 击 Delete Node Zl, Htr Loop 按钮 ， 树 中 的 最 后 一 个 节点 融会 消失 。 
示例 说 明 


把 XML 加 载 到 XmlDocument 对 象 上 后 ， 就 检查 根 元 系 ， 确 定 在 加 载 的 XML PERATIA. WRA, mE 
用 XmlElement 类 的 LastChild 属性 获取 最 后 一 个 子 元 系 。 之 后 ， 调 用 RemoveChild， 给 它 传 送 要 删除 的 元 素 实 例 (在 
本 例 中 是 根 元 素 的 最 后 一 个 子 元 素 )， 就 删除 了 该 元 素 。 

3. 选择 节点 

前 面 介绍 了 如 何 浏 览 XML 文档 、 如 何 操作 文档 的 值 、 如 何 创 建新 节点 以 及 如 何 删除 它们 。 剩 下 的 就 是 在 
不 表 历 整个 树 的 情况 下 选择 节点 。 

XmlNode 类 包含 的 两 个 方法 常用 于 从 文档 中 选择 节点 ， 且 不 授 历 其 中 的 每 个 节点 ， 如 表 21-7 所 示 。 这 两 
个 方法 是 SelectSingleNode 和 SelectNodes， 它 们 都 使 用 一 种 特殊 的 查询 语言 XPath 来 选择 节点 。 稍 后 将 介绍 议 


语言 。 
表 21-7 用 于 选择 节点 的 方法 
方 i iH PA 
SelectSingleNode 选择 一 个 节 上 后。 如 果 创 建 一 个 查找 多 个 节操 的 查询 ， 就 只 返回 第 一 个 节操 
SelectNodes 以 XmlNodeList 类 的 形式 返回 一 个 节点 集合 


21.5 #2 XML 转换 为 JSON 


章 开 头 提 到 过 JSON 数据 语言 。C# 系 统 库 有 限 地 支持 JSON， 但 是 可 以 使 用 一 个 免费 的 第 三 方 JSON JE, 
将 XML 转换 为 JSON, 将 ISON 转换 为 XML， 用 JSON 完成 其 他 操作 ， 类 似 于 用 .NET 类 处 理 XML。 在 Visual 
Studio 中 ,可 以 通过 NuGet Package Manager 获得 的 一 个 这 样 的 库 是 Newtonsoft JSON.NET 包 。 这 个 包 的 帮助 信 
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妃 和 完整 教程 可 在 www.json.net 上 获得 。 
下 面 的 简短 例子 扩展 了 本 章 前 面 示例 创建 的 应 用 程序 ， 能 将 XML 转换 为 JSON。 


试 一 试 转换: Chapter21\LoopThroughXmlDocument\MainWindow.xaml.cs 


这 个 例子 建立 在 前 面 创建 的 LoopThroughXmlDocument 项 目的 基础 上 。 通 过 以 下 步骤 可 以 找到 、 删 除 book 


节点 的 最 后 一 个 实例 : 
(1) 在 Visual Studio 3%}, 进入 Tools | NuGet Package Manager | Manage NuGet Packages for Solution. 选择 


Newtonsoft.Json &, Anl 21-6 Prax. 75 Install 按钮 ， 然 后 在 Review Changes 对 话 杠 中 单 击 OK 按钮 ， 完 成 


De 
co 
28 MiainWindow xaml Iain Window xarml.cs 
Manage Packages for Solution 


Browse Installed Updates Consalidate 
Package source  nuxget.org - Œ 


Search (Ctrl« E P- & [ ] Include prerelease 


ff Newtonsoft.Ison 


d NewtonsoftJson by James Newton-King, 85.5M downloads 
Jeon NET = a popular high-performance DOH framework for MET Versien(s) -Ù 
| Project 


@ NUnit by Charlie Poole Rob Prouse, 13.7M downloads 
Fnit is a unit-besting framework Tor all JWET languages with a strong TOO focus, 


| ner EntityFramework by Microsoft, 35.1M downloads 
Enbrty Framework is Microsoft's recommended data access technology for new applications. 


Installed: not installed 


Wersione — Latest stable 10.0.5 


图 21-6 


(2) 在 三 个 已 有 按钮 的 下 面 湛 加 一 个 新 按钮 ， 并 命名 为 buttonXMLtoJSON。 把 它 的 Content 属性 设 


XML > JSON. 
(3) 双击 这 个 新 按钮 ， 输 入 以 下 代码 : 
private void buttonXMLtoJSON Click(object sender, RoutedEventArgs e) 
{ 
// Load the XML document. 
XmlDocument document = new XmlDocument (); 
document. Load (booksFile); 


string json = Newtonsoft.Json.JsonConvert.SerializeXmlNode (document); 
textBlockResults.Text = json; 


} 
(4) 运行 该 应 用 程序 。 单 击 XML > ISON 按钮 。 本 书 的 ISON 版 本 数据 就 显示 在 主 窗 口中 ,如 图 21-7 所 示 。 


books": "book": H "title": "Beginning Visual C# 
2015" ,“author’:"Benamin Perkins et al”,"code":"096689"}, 
itle";"Beginning XML ","author":" Joe Fawcett et 


("title 
al","code":"162132"}]}} 


图 21-7 


示例 说 明 
开头 几 步 将 XML 加 载 到 XmlDocument 对 象 中 ， 此 后 调用 Newtonsoft ISON 包 方 法 JsonConvert.Serialize- 


XmlNode 将 XML 文档 转换 为 JSON 格式 的 文本 字符 串 。 接 独 在 已 加 载 的 XML 的 任何 子 元 素 中 显示 JSON 文本 。 
如 果 有 任何 子 元 素 ， 就 使 用 textBlockResults 窗口 。 可 以 看 出 ，JSON 版 本 的 图 书 数据 比 XML 更 紧凑 ， 但 有 点 
难以 阅读 。 所 以 ，JSON 常用 于 网 络 上 的 数据 传输 ， 而 不 是 存储 在 可 能 由 人 们 直接 读 取 的 文件 里 。 
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21.6 ”用 XPath 搜索 XML 


XPath 是 XML 文档 的 得 询 语言 , 就 像 SQL 是 关系 数据 库 的 查询 语言 一 样 。 它 由 表 21-7 中 的 两 个 方法 使 用 ， 
RIR XML 文档 的 整个 树 。 但 是 需要 伦 一 定 的 时 间 才 能 熟悉 它 ， 因 为 其 语法 与 SQL 或 C# 完 全 不 同 。 


注意 : 
XPath 相当 复杂 ， 这 里 只 介绍 其 中 的 一 小 部 分 ， 就 足以 选择 节点 了 。 如 果 想 了 解 XPath 的 更 多 内 容 ， 可 参 
阅 www.w3.org/TR/xpath 和 Visual Studio 帮助 页 面 。 


为 正确 使 用 XPath， 下 面 要 使 用 XML 文件 Elements xml。 该 文档 包含 元 素 周 期 表 中 的 部 分 化 学 元 素 。 这 个 
XML 文件 的 部 分 内 容 列 在 稍 后 的 选择 节点 "示例 中 , 其 完整 内 容 可 以 在 本 书 网 站 的 本 章 下 载 代码 Elements xml 
中 找到 。 

表 21-8 列 出 了 XPath 执行 的 最 常见 操作 。 如 果 未 特别 说 明 ，XPath 查询 示例 就 根据 它 操作 的 节点 来 选择 。 
在 必须 有 一 个 节点 名 称 的 地 方 ， 可 以 假定 当前 节点 是 XML 文档 中 的 <element> 节 点 。 


表 21-8 XPath 的 常见 操作 


目 的 XPath 查询 示例 
选择 当前 节点 的 父 节 点 
选择 当前 节点 的 所 有 子 节点 * 
选择 具有 特定 名 称 的 所 有 子 节点 ， 这 里 是 title Title 
选择 当前 节点 的 一 个 特性 @Type 
选择 当前 节点 的 所 有 特性 @* 
按照 索引 选择 一 个 子 节点 ， 这 里 是 第 二 个 元 素 节 点 element[2] 
选择 当前 节点 的 所 有 文本 节点 text() 
选择 当前 节点 的 一 个 或 多 个 孙子 节点 element/text() 
在 文档 中 选择 具有 特定 名 称 的 所 有 节点 ， 在 这 里 是 所 有 的 mass 节点 //mass 


在 文档 中 选择 具有 特定 名 称 和 特定 父 节 点 名 称 的 所 有 贡 点 ， 在 这 里 父 节 点 名 称 是 | /element/name 
element， 节 点 名 称 是 name 


选择 值 满足 条 件 的 节点 ， 这 里 选择 元 素 名 为 Hydrogen 的 元 素 Welementlname= Hydrogen 
选择 特性 值 满 足 条 件 的 节点， 在 此 ，Type 特性 的 值 是 Noble Gas /element[@Type=Noble Gas] 


下 面 的 示例 要 创建 一 个 小 型 应 用 程序 , 以 执行 许多 预定 义 的 得 询 , 得 看 结果 , 并 可 以 输入 目 己 的 查询 。 


试 一 试 ”选择 节 点 : Chapter21\XpathQuery\Elements.xml 


如 前 所 示 ， 这 个 示例 使 用 新 的 XML 文件 Elements.xml。 可 以 从 本 书 的 网 站 上 下 载 这 个 文件 ， 或 者 输入 下 
面 的 代码 : 
<?xml version="1.0"?> 
<elements> 
<!—-First Non-Metal-——-> 
«element Type-"Non-Metal"» 
<name>Hydrogen< /name> 
<symbol>H</symbol> 
<number>1< /number> 
<specification> 
<mass>1.007/7825</mass> 
<density>0.0899 g/cm3</density> 
</specification> 
</element> 
<!—-First Noble Gas 一 一 > 
«element Type-"Noble Gas"> 
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<name>Helium</name> 
<symbol>He</symbol> 
<number>2< /number> 
<specification> 
<mass>4.002602</mass> 
<density>0.1785 g/cm3</density> 
</specification> 
</element> 
<!--First Halogen--> 
<element Type-"Halogen"- 
<name>Fluorine</name> 
<symbol>F</symbol> 
<number>9< /number> 
<specification> 
<mass>18.998404</mass> 
<density>1.696 g/cm3</density> 
</specification> 
</element> 
<element Type="Noble Gas"> 
<name>Neon</name> 
<symbol>Ne</symbol> 
<number>10</number> 
<specification> 
<mass>20.1/97/</mass> 
<density>0.901 g/cm3</density> 
</specification> 
</element> 
</elements> 


把 这 个 XML 文件 保存 为 Elements.xml。 一 定 要 修改 下 述 代码 中 文件 的 路 径 。 这 个 示例 是 一 个 小 型 查询 工 
具 ， 可 用 于 测试 通过 代码 提供 的 XML 上 的 不 同 碍 询 。 

按照 下 面 的 步骤 创建 一 个 具有 得 询 功能 的 WPF 应 用 程序 。 

(1) 创建 一 个 新 的 WPF 应 用 程序 ， 命 名 为 XPath Query. 

(2) 创建 如 图 21-8 所 示 的 对 话 框 。 按 照 图 中 所 示 给 控件 命名 ， 但 按钮 除外 ， 它 应 命名 为 buttonExecute， 将 
textBlock 放 到 一 个 ScrollViewer 控件 中 ， 并 将 其 VerticalScrollBarVisibility 属性 设 为 Auto。 


Query: | textBoxQuery 


图 21-8 


(3) 进入 代码 视图 ， 添 加 using 指令 。 
(4) 接 看 ， 添 加 一 个 私有 字段 来 保存 文档 ， 在 构造 函数 中 初始 化 它 : 
private XmlDocument document; 
public MainWindow () 
i InitializeComponent (); 
document = new XmlDocument (); 


document. Load (@"C:\BeginningCSharp7\Chapter21\XML and Schema\Elements.xml"); 
} 


(5) 在 此 需要 使 用 几 个 帮助 方法 ， 以 便 在 textBlockResult 文本 框 中 显示 得 询 结果 : 


private void Update(XmlNodeList nodes) 


{ 
if (nodes == null || nodes.Count == 0) 
{ 
textBlockResult.Text = "The query yielded no results"; 
return; 
} 


string text = ""; 
foreach (XmlNode node in nodes) 


{ 

text = FormatText (node, text, "") + "\r\n"; 
} 
textBlockResult.Text = text; 


(6) 更 新 构造 函数 ， 以 便 在 应 用 程序 局 动 时 显示 XML 文件 的 全 部 内 容 : 


public MainWindow () 
{ 
InitializeComponent (); 
document = new XmlDocument (); 


document. Load (@"C:\BeginningCSharp7\Chapter21\XML and Schemas\Elements.xml"); 


Update (document .DocumentElement.SelectNodes(".")); 


} 


(7) 将 上 一 个 “ 试 一 试 ”示例 中 的 FormatText 和 AddAttributes 方法 复制 并 粘贴 到 新 项 目 中 。 


(8) 最 后 插入 代码 ， 执 行 用 尸 在 文本 框 中 输入 的 内 容 : 


private void buttonExecute Click(object sender, RoutedEventArgs e) 


{ 
try 


{ 


XmlNodeList nodes = document. DocumentElement.SelectNodes (textBoxQuery.Text); 


Update (nodes); 
} 
catch (Exception err) 
{ 
textBlockResult.Text = err.Message; 
} 
} 
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(9) 运行 该 应 用 程序 ， 在 textBoxQuery MATE PHA PMMA, EAXeTE— T7638 Boa, APE UA 


Hydrogen 的 节点 。 


element [name="Hydrogen' ] 


示例 说 明 


buttonExecute Click 是 执行 得 询 的 方法 。 因 为 我 们 不 可 能 事先 知道 输入 到 textBoxQuery "PIS fri z 4E — 
个 还 是 多 个 市 把 ， 所 以 必须 使 用 SelectNodes 方法 。 该 方法 返回 一 个 XmlNodeList 对 象 ， 但 如 果 所 使 用 的 查询 是 


非法 的 ， 该 方法 就 抛 出 一 个 与 XPath HRUE A o 


Update 方法 负责 遍历 SelectNodes 选择 出 来 的 XmlNodeList 的 内 容 。 它 对 每 个 节点 调用 前 面 示例 中 的 


FormatText, FormatText 负责 递归 过 有 历 节 点 树 ， 创 建 可 在 textBlockResult 控件 中 该 取 的 文本 。 


在 本 草 最 后 的 习题 中 , 读者 需要 执行 其 他 许多 XPath Aw. 在 把 它们 输入 XPathQuery 应 用 程序 中 查看 结果 


之 前 ， 尝 试 自己 确定 查询 结果 。 


21.7 “习题 


(1) 修改 “创建 节点 ”示例 中 的 插入 方式 ， 把 值 为 1000+ 的 特性 Pages 插入 book “i 5i. 


(2) 确定 下 述 XPath 香 询 的 结束 ， 再 把 坦 询 输入 “选择 节点 ”示例 中 的 XPathQuery 应 用 程序 ， 来 验证 目 己 


的 结果 。 注 意 所 有 碍 询 都 在 元 素 节 所 DocumentElement 上 执行 。 


//elements 

element 

element [@Type="Noble Gas'] 
/ /mass 
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//mass/.. 
element/specification[mass-'20.1797'] 
element/name[text ()-'Neon'] 

Solution: 


(3) 在 许多 Windows 系统 中 ，XML 的 默认 查看 器 都 是 Web 浏览 器 。 如 果 使 用 Internet Explorer， 在 其 中 加 
载 Elements xml 文件 ， 就 会 看 到 美观 的 XML 的 格式 化 视图 。 在 浏览 器 控件 (而 不 是 文本 框 ) 中 显示 查询 的 XML 
的 效果 为 什么 不 理想 ? 

(4) 使 用 Newtonsoft 库 将 JSON 转换 成 XML 按钮 (与 本 章 所 示 的 例子 反问 )。 

附录 A 给 出 了 习题 答案 。 
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+ 题 要 点 
用 XML 声明 、XML 名 称 空间 、XML 元 素 和 特性 来 创建 XML 文档 。XML 声明 定义 了 XML 版 本 ，XML 名 
称 空 间 用 于 定义 词汇 表 ，XML 元 素 和 特性 用 于 定义 XML 文档 的 内 容 
JSON 基本 语法 | ISON 是 传输 JavaScript 和 Web 服务 时 使 用 的 一 种 数据 语言 。JSON EG XML ERKE, (AMELIE 
XML 模式 用 于 定义 XML 文档 的 结构 。 需 要 与 第 三 方 交 换 信 息 时 ， 模 式 特 别 有 用 。 对 所 交换 的 数据 的 模式 达 


XML 基本 语法 


XML 模式 | y 
成 一 致 后 ， 我 们 和 第 三 方 就 可 以 检查 该 文档 是 否 有 效 
XML DOM XML 文档 对 象 模型 (DOM) 是 .NET Framework 的 基础 ， 提 供 了 创建 和 操纵 XML 的 功能 
— 可 使 用 JSON 包 ( 如 Newtonsoft) XML 转换 为 ISON, 4 ISON 转换 为 XML， 用 JSON 完成 其 他 操作 ， 类 似 
于 用 .NET 类 处 理 XML 
XPath 是 在 XML 文档 中 查询 数据 的 方式 之 一 。 要 使 用 XPath， 就 必须 熟悉 XML 文档 的 结构 ， 这 样 才能 从 中 
XPath 选择 各 个 元 素 。 尽 管 XPath 可 以 用 于 任何 格式 良好 的 XML 文档 ， 但 创建 查询 时 必须 了 解 文档 的 结构 ， 这 


意味 着 确保 文档 有 效 ， 也 束 确 保 了 只 要 文档 对 于 同一 个 模式 而 言 是 有 效 的 ， 查 询 束 可 以 用 于 多 个 文档 


zz 


LINQ 


KEAN: 

LINQ to XML 

LINQ 提供 程序 

LINQ 查询 语法 

LINQ 方法 语法 

对 香 询 结果 排序 

聚合 (Count、Sum、Min、Max、Average) 
SelectDistinctQuery 

分 组 查询 

join Æ] 


本 章 源 代 码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代 码 位 于 Chapter22 文件 夹 中 并 已 根据 本 草 示 例 的 名 称 单 
独 命名 。 


本 章 介绍 Language INtegrated Query(LINQ)， 这 是 C# 语 言 的 一 个 扩展 ， 可 以 将 数据 但 询 直 接 集 成 到 编程 语 
BASH. 

过 去 ， 完 成 这 类 任务 需要 编写 大 量 的 循环 代码 ， 而 额外 的 处 理 甚至 需要 更 多 的 代码 ， 例 如 ， 排 序 或 组 合 
找到 的 对 象 ， 因 为 数据 源 的 不 同 会 导致 差异 。 而 LINQ 提供 了 一 种 可 移植 的 、 一 致 的 方式 ， 来 得 询 、 排 序 和 分 
组 许多 不 同 种 类 的 数据 (XML、JSON、SQL 数据 库 、 对 象 集合 、Web 服务 、 企 业 目 录 等 )。 

首先 以 上 一 章 的 内 容 为 基础 ， 和 学 习 systemxmlling 名 称 空间 添加 的 、 用 于 创建 XML 的 附加 功能 ， 然 后 进 
A LINQ 的 核心 ， 学 习 如 何 使 用 查询 语法 、 方 法 语法 、Lambda 表达 式 、 排 序 、 分 组 、 连 接 相关 的 结果 。 

LINQ 非 党 大 , 完整 地 介绍 它 的 所 有 特性 和 方法 已 超出 了 本 书 的 讨论 范围 。 但 本 章 将 列举 LINQ 用 户 需 要 的 
所 有 运算 符 和 语句 类 型 的 示例 ， 并 酌情 给 出 深入 探讨 这 些 主题 的 资料 。 


478 | 第 部 分 数据 访问 


22.1 LINQ to XML 
LINQ to XML 是 用 于 XML 的 一 组 附加 类 ， 以 使 用 LINQ to XML 数据 ， 如 果 以 前 没有 使 用 LINQ, LINQ to 


XML 还 可 以 更 方便 地 对 XML 执行 某 些 操作 。 这 里 介绍 LINQ to XML 优 于 上 一 章 讨 论 的 XML DOM 的 几 种 特 
殊 情 形 。 


22.1.1 LINQ to XML 函数 构造 方式 


可 在 代码 中 用 XML DOM 创建 XML 文档 , 而 LINQ to XML 提供 了 一 种 更 便捷 的 方式 , 称 为 函数 构造 方式 
(functional construction)。 在 这 种 方式 中 ， 构 造 函 数 的 调用 可 以 用 反映 XML 文档 结构 的 方式 散 套 。 下 面 的 示例 
残 使 用 图 数 构造 方式 建立 了 一 个 包含 顾客 和 订单 的 简单 XML 文档 。 


试 一 试 LINQ to XML: BeginningCSharp7 22 1 LinqToXmlConstructors 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) f£ C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 全 应 用 程序 BeginningCSharp7 22 1 
LinqloXmlConstructors。 

(2) 打开 主 源 文件 Program.cs. 

(3) 在 Program.cs 的 开头 处 添加 对 System.Xml.Ling 名 称 空间 的 引用 ， 如 下 所 示 : 

using System; 

using System.Collections.Generic; 

using System.Ling; 

using System.Xml.Linq; 


using System.Text; 
using static System.Console; 


(4) 在 Program.cs 的 Main0 方 法 中 添加 如 下 代码 : 


static void Main(string[] args) 


{ 
XDocument xdoc = new XDocument( 
new XElement("customers", 
new XElement("customer", 
new XAttribute("ID", "A"), 
new XAttribute("City", "New York"), 
new XAttribute("Region", "North America"), 
new XElement("order", 
new XAttribute("Item", "Widget"), 
new XAttribute("Price", 100) 
), 
new XElement("order", 
new XAttribute("Item", "Tire"), 
new XAttribute("Price", 220) 
) 
) , 
new XElement("customer", 
new XAttribute("ID", "B"), 
new XAttribute("City", "Mumbai"), 
new XAttribute("Region", "Asia"), 
new XElement("order", 
new XAttribute("Item", "Oven"), 
new XAttribute ("Price", 501) 
) 
) 
) 
) ; 
WriteLine (xdoc) ; 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine(); 
} 
(5) 编译 并 执行 程序 ( 按 下 FS 键 即 可 开始 调试 )， 输 出 结果 如 下 所 示 : 
<customers> 


«customer ID-"A" City="New York" Region-"North America"» 
«order Item-"Widget" Price-"100" /> 
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«order Item-"Tire" Price="200" /> 
</customer> 
<customer ID="B" City="Mumbai" Region="Asia"> 
<order Item-"Oven" Price-"501" /> 
</customer> 
</customers> 
Program finished, press Enter/Return to continue: 


在 输出 屏幕 上 显示 的 XML 文档 包含 前 面 示例 中 顾客 /订单 数据 的 一 个 简化 版 本 。 注 意 ，XML 文档 的 根 元 
Fa7e<customers>, “EAA AME <customer>ItR, MMA 7628 LAI e WE ]-order»762&» <customer> 
元 系 有 具有 两 个 特性 : City 和 Region，=<order> 元 素 也 有 两 个 特性 : Item 和 Price. 

按 下 Enter/Retum 键 ， 退 出 程序 ， 关 闭 控 制 台 屏 旨 。 如 果 使 用 CtrItF5 组 合 键 ( 局 动 时 不 使 用 调试 功能 )， 就 
ii 224% Enter/Return Sp X. 


示例 说 明 
第 一 步 是 引用 System Xml.Linq 名 称 空间 。 本 章 的 所 有 XML 示例 都 要 求 把 这 行 代码 添加 到 程序 中 : 


using System.Xml.Linq; 


在 创建 项 目 时 ，System.Linq 名 称 空间 是 默认 包含 的 ， 但 不 包含 System.Xml.Linq 名 称 空间 ， 所 以 必须 显 式 
地 添加 这 行 代 码 。 
接 看 调用 LINQ to XML 构造 函数 XDocument(). XElement()fll XAttribute), "fill ieE, "n Br: 
XDocument xdoc = new XDocument ( 
new XElement("customers", 


new XElement("customer", 
new XAttribute("ID", "A"), 


注意 ， 这 些 代码 看 起 来 类 似 于 XML 本 号， 即 文档 包 仿 元素， 每 个 元 素 义 包含 特性 和 其 他 元 素 。 下 面 依次 

e XDocument(): 在 LINQ to XML 构造 函数 层次 结构 中 ， 最 高 层 的 对 象 是 XDocument0， 它 表示 完整 的 
XML 文档 ， 在 代码 中 如 下 所 示 : 

static void Main(string[] args) 


{ 


XDocument xdoc = new XDocument ( 
) 7 
在 前 面 的 代码 段 中 ， 省 略 了 XDocument0 的 参数 列表 ， 因 此 可 以 看 到 XDocumentO 调 用 在 何 处 开始 和 结束 。 
与 所 有 LINQ to XML 构造 函数 一 样 ，XDocument0 也 把 对 象 数组 (object[]) 作 为 它 的 参数 之 一 ， 以 便 给 它 传 递 其 
他 构造 函数 创建 的 其 他 多 个 对 象 。 在 这 个 程序 中 调用 的 所 有 其 他 构造 函数 都 是 XDocument0 构 造 图 数 的 参数 。 
这 个 程序 传递 的 第 一 个 也 是 唯一 一 个 参数 是 XElement() 435 PR 2 . 
e XElement): XML 文档 必须 有 一 个 根 元 素 ， 所 以 大 多 数 情况 下 ，XDocument0 的 参数 列表 都 以 一 个 
XElement 对 象 开 涉 。XElement0 构 造 函 数 把 元 每 名 作为 字符 串 ， 其 后 是 包含 在 该 元 素 中 的 一 个 XML 对 
象 列表 。 本 例 中 的 根 元 素 是 customers， 它 又 包含 一 个 customer 元 素 列 表 : 


new XElement ("customers", 
new XElement ("customer", 


E 
) 
customer 元 素 不 包含 其 他 XML 元 素 ， 只 包含 3 个 XML 特性 ， 它 们 用 XAttribute) 35 Ph BOE 
e XAttribute): 这 里 给 customer 元 素 添 加 了 3 个 XML 特性 : ID, City 和 Region: 
new XAttribute("ID", "A"), 
new XAttribute("City", "New York"), 


new XAttribute("Region", "North America"), 


根据 定义 ，XML 特性 是 一 个 XML PET Ex, “EAE EU XML 节操， 所 以 XAttribute0 构 造 函数 的 参数 只 
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有 特性 的 名 称 和 值 。 本 例 中 生成 的 3 个 特性 是 ID="A"、City="New York" 和 Region="North America". 

e 其 他 LINQ to XML 构造 图 数 : 这 个 程序 中 没有 调用 它们 , 但 所 有 XML T5288 81/6 Ht LINQ to XML 
构造 冰 数 ， 例 如 ，XDeclaration0 用 于 XML 文档 开头 的 XML 声明 ，XComment0 用 于 XML 注释 等 。 这 些 
构造 函数 不 太 沼 用， 但 如 果 需 要 它们 来 精确 控制 XML 文档 的 格式 化 ， 就 可 以 使 用 它们 。 

下 面 继续 解释 第 一 个 示例 : 在 customer LAH ID. City 和 Region 特性 后 面 再 添加 两 个 子 order 762: 

new XElement ("order=", 
new XAttribute("Item", "widget"), 
new XAttribute("Price", 100) 
— 
new XAttribute("Item", "Tire"), 
new XAttribute("Price", 200) 
) 


这 些 order TUR ABA PT REPE: Item 和 Price, HZ SICH. 
接着 将 XDocument 的 内 容 显示 在 控制 台 屏 幕 上 : 
WriteLine (xdoc); 
这 行 代 码 使 用 XDocumentO 的 默认 方法 ToStrng0 输 出 XML 文档 的 文本 。 
最 后 暂停 屏 医 ， 以 便 得 看 控制 台 输 出 ， 册 等 竺 用 户 按 下 回 千 键 : 


Write("Program finished, press Enter/Return to continue:"); 
ReadLine (); 


程序 退出 Main0 方 法 后 ， 就 结束 程序 。 
22.1.2 AN XML HE 

与 一 些 XML DOM 不 同 ，LINQ to XML 处 理 XML 片段 (部 分 或 不 完整 的 XML 文档 ) 的 方式 与 处 理 完整 的 
XML 文档 几乎 完全 相同 。 在 处 理 片 段 时 ， 只 需要 将 XElement( 而 不 是 XDocument) 当 作 顶 级 XML 对 象 。 


注意 : 
唯一 的 限制 是 不 能 添加 某 些 比较 深奥 的 、 只 能 应 用 于 XML 文档 或 XML 片段 的 XML 节点 类 型 ， 例 如 ， 
XComment 应 用 于 XML 注释 ,XDeclaration 应 用 于 XML 文档 声明 , XProcessingInstruction 用 于 XML 处 理 指 令 。 


下 面 的 示例 会 加 载 、 保 在 和 处 理 XML 元 素 及 其 子 节点 ， 这 与 处 理 XML 文档 一 样 。 


试 一 试 ” 处 理 XML 片段 : BeginningCSharp7 22 2 XMLFragments 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) 在 C:\BeginningCSharp7\Chapter22 目录 中 修改 上 一 个 示例 或 者 创建 一 个 新 的 控制 台 应 用 程序 
BeginningCSharp7 22 2 XMLFragments. 

(2) 打开 主 源 文件 Program.cs. 

(3) 在 Program.cs 开头 处 添加 对 System.Xml.Ling 名 称 空 间 的 引用 ， 如 下 所 示 ; 

using System; 

using System.Collections.Generic; 

using System.Xml.Linq; 

using System.Text; 

using static System.Console; 

如 果 正 在 修改 上 一 个 示例 ， 则 已 经 引用 了 这 个 名 称 空间 。 

(4) 把 上 一 个 示例 中 的 XML 元 素 (不 包含 XML 文档 构造 函数 ) 添 加 到 Program.cs 的 Main0 方 法 中 : 

static void Main(string[] args) 

{ 

XElement xcust = 
new XElement("customers", 


new XElement("customer", 
new XAttribute("ID", "A"), 
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new XAttribute("City", "New York"), 
new XAttribute("Region", "North America"), 
new XElement("order", 
new XAttribute("Item", "Widget"), 
new XAttribute("Price", 100) 
), 
new XElement("order", 
new XAttribute("Item", "Tire"), 
new XAttribute("Price", 200) 
) 
) ， 
new XElement("customer", 
new XAttribute("ID", "B"), 
new XAttribute("City", "Mumbai"), 
new XAttribute("Region", "Asia"), 
new XElement("order", 
new XAttribute("Item", "Oven"), 
new XAttribute("Price", 501) 


* 
F 
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(5) 在 上 一 步 添 加 JXML oR MESA, A PINES, DERT MRAR XML 7635: 


string xmlFileName = 
@"c:\BeginningCSharp7\Chapter22\BeginningCSharp7 22 2 XMLFragments\fragment.xml"; 

xcust.Save(xmlFileName); 

XElement xcust2 = XElement.Load(xmlFileName); 

WriteLine("Contents of xcust:"); 

WriteLine (xcust); 

Write("Program finished, press Enter/Return to continue:"); 

ReadLine (); 


注意 : 


xmlFileName 是 一 个 绝对 路 径 ; 读者 的 文件 夹 结构 可 能 不 同 ， 此 时 ， 应 该 调整 路 径 ， 以 反映 自己 计算 机 上 


(6) 编 详 并 执行 程序 ( 按 下 FS 键 即 可 局 动 调试 )， 控 制 台 窗口 中 的 输出 结果 如 下 所 示 : 


Contents of XElement xcust2: 
<customers> 
«customer ID-"A" City="New York" Region-"North America"™> 
«order Item-"Widget" Price="100" /> 
<order Item-"Tire" Price-"200" /> 
</customer> 
«customer ID="B" City="Mumbai" Region="Asia"> 
<order Item-"Oven" Price-"501" /» 
</customer> 
</customers> 
Program finished, press Enter/Return to continue: 


按 下 Enter/Retum $È, LEH REE. RAIER t BEA. WARE Col FS 组 合 键 (局 动 时 不 使 用 调试 功能 )， 


就 需要 按 下 Enter/Return 键 两 次 。 


示例 说 明 


XElement 和 XDocument 都 继承 日 LINQ to XML 类 XContainer， 它 实现 了 一 个 可 以 包含 其 他 XML TA 
的 XML 节点 。 这 两 个 类 都 实现 了 Load0 和 Save0 方 法 ， 因 此 ， 可 在 LINQ to XML 的 XDocument 上 执行 的 大 多 


数 操作 都 可 以 在 XElement 实例 及 其 子 元 素 上 执行 。 


这 里 只 创建 了 一 个 XElement 实例 ， 它 的 结构 与 前 面 示例 中 的 XDocument 相同 ， 但 不 包含 XDocument。 这 


个 程序 的 所 有 操作 处 理 的 都 是 XElement 片段 。 
XElement 还 文 持 Load0 和 Parse0 方 法 ， 可 以 分 别 从 文件 和 字符 串 中 加 载 KML. 


482 | 第 部 分 数据 访问 


222 LINO 提供 程序 


LINQ to XML 只 是 LINQ 提供 程序 的 一 个 例子 。Visual Studio 2017 和 .NET Framework 4.7 有 许多 内 置 的 
LINQ 提供 程序 ， 为 不 同类 型 的 数据 提供 了 查询 解决 方案 : 
e LINQ to Objects: 对 任何 类 型 的 C# 内 存 中 对 象 提供 查询 ， 比 如 数组 、 列 表 和 其 他 集合 类 型 。 上 一 章 的 
所 有 例子 都 使 用 了 LINQ to Objects。 也 可 以 把 在 本 章 学 到 的 技术 应 用 于 LINQ 的 所 有 变 体 。 
e LINQ to XML: 如 前 所 述 ， 它 使 用 与 其 他 LINQ 变 体 相同 的 语法 和 通用 查询 机 制 ， 来 创建 和 操纵 XML 


文档。 

e LINQ to Entities: Entity Framework 是 NET 中 最 新 的 数据 接口 类 ，Microsoft 建议 使 用 它 进行 新 的 开发 
工作 。 

è LINQ to Data Set: DataSet 对 象 在 NET Framework 的 第 1 版 引入 。 这 个 LINQ 变 体 文 持 使 用 LINQ 方 
便 地 查询 旧 的 .NET 数据 。 


e LINQtoSQL: 这 是 另 一 个 LINQ 接口 ， 取 代 了 LINQ to Entities. 
e PLINQ: PLINQ 是 并 行 LINQ, 用 并 行 编程 库 扩展 了 LINQ to Objects， 可 以 拆 分 得 询 ， 让 它们 在 多 核 处 
理 右 上 同时 执行 。 
e LINQ to JSON: 包含 在 上 一 章 使 用 的 Newtonsoft 包 中 ， 这 个 库 支持 使 用 与 其 他 LINQ 变 体 相同 的 语法 
和 通用 查询 机 制 ， 来 创建 和 操纵 ISON 文档 。 
有 这 么 多 种 类 的 LINQ, 一 本 入 门 书籍 不 可 能 窗 新 所 有 内 容 ， 但 其 语法 和 方法 适用 于 所 有 的 种 类 。 接 下 来 
使 用 LINQ to Objects 提供 程序 介绍 LINQ 查询 语法 。 


22.3 LINQ 查询 语法 


下 例 使 用 LINQ 创建 了 一 个 查询 ， 以 便 在 一 个 简单 的 内 存 对 象 数组 中 查找 一 些 数据 ， 并 输出 到 控制 台 上 。 
试 一 试 ”第 一 个 LINQ 程序 : BeginningCSharp7 22 3 QuerySyntax\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) 在 C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 22 3_ 
QuerySyntax， 然 后 打开 主 源 文件 Program cs。 

(2) 注意 ，Visual Studio 2017 默认 在 Program.cs 中 包含 System.Linq 名 称 空间 : 


using System; 

using System.Collections.Generic; 
using System.Linq; 

using System.Text; 

using static System.Console; 


(3) 在 Program.cs 的 Main0 方 法 中 添加 如 下 代码 : 


static void Main(string[] args) 
{ 
string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", 
"Small", "Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 
var queryResults = 
from n in names 
where n.StartswWith("S") 
select n; 
WriteLine("Names beginning with 5:"); 
foreach (var item in queryResults) { 
WriteLine (item); 
} 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine () ; 
} 


(4) 编译 并 执行 程序 ( 按 下 F5 键 即 可 局 动 调试 )， 列 表 中 的 名 称 以 S 开头 ， 按 照 它 们 在 数组 中 的 声明 顺序 排 
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Names beginning with S: 

Smith 

Smythe 

Small 

Singh 

Samba 

Program finished, press Enter/Return to continue: 


按 下 Enter/Retun 键 ， 结 束 程序 ， 关 闭 控 制 台 屏幕 。 如 果 使 用 CoH PS 组 合 键 (启动 时 不 使 用 调试 功能 )， 就 
需要 按 下 Enter/Retum 键 两 次 ， 这 会 结束 程序 的 运行 。 


示例 说 明 
第 一 步 是 引用 System.Linq 名 称 空间 ， 这 在 创建 项 目 时 由 Visual Studio 2017 目 动 完成 : 


using System.Linq; 


所 有 的 基本 撒 层 系统 孝文 持 System.Ling 名 称 空间 中 用 于 LINQ 的 类 。 如 果 在 Visual Studio 2017 外 部 创建 
C 胡 原文 件 或 编辑 以 前 版本 创建 的 项 目 ， 束 必须 手动 添加 using System.Linq 指令 。 
下 一 步 创建 一 些 数据 ， 在 本 例 中 就 是 声明 并 初始 化 names 数组 : 


string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", "Small", 
"Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 
这 些 数据 很 少 ， 很 适合 用 于 得 询 结果 比较 明显 的 示例 。 程 序 的 下 一 部 分 是 真正 的 LINQ Aria): 
var queryResults = 
from n in names 
where n.StartsWith("S") 
select n; 


这 是 一 个 看 起 来 比较 古怪 的 语句 。 它 不 像 是 C# 语 言 , 实际 上 from. where. select 语法 类 似 于 SQL 数据 库 查 
询 语言 。 但 这 个 语句 不 是 SQL， 而 是 C#， 在 Visual Studio 2017 中 输入 这 些 代 码 时 ，from、where 和 select 2€ 
出 显示 为 关键 字 ， 这 个 古怪 的 语法 对 编 详 右 而 言 是 完全 正确 的 。 
这 个 程序 中 的 LINQ Arve A) fe Hl f. LINQ 声明 性 得 询 语法 : 
Var enu eg i = 


where n.StartsWith("s") 
select n; 


该 语句 包括 4 个 部 分 : 以 var 开头 的 结果 变量 声明 ， 使 用 查询 表达 式 给 该 结果 变量 赋值 ， 查 询 表 达 式 包含 
from FAJ, where 子 句 和 select 子 句 。 下 面 逐 一 介绍 它们 。 


223.1 用 Var 关键 字 声 明 结果 变量 
LINQ 查询 首先 声明 一 个 变量 ， 以 包含 查询 的 结果 ， 这 通常 是 用 var 关键 字 声 明 一 个 变量 来 完成 的 : 
Var queryResult = 


var 是 C# 中 的 一 个 新 关键 字 ， 用 于 声明 一 般 的 变量 类 型 ， 特 别 适 于 包含 LINQ AWA R. var 关键 字 告 诉 
C# 纲 详 器 ， 根 据 香 询 推断 结果 的 类 型 。 这 样 ， 就 不 必 提 前 声明 从 LINQ 埋 询 返回 的 对 象 类 型 了 一 一 纺 详 器 会 推 
断 出 该 类 型 。 如 果 介 询 返回 多 个 条 目 ， 访 变量 束 是 俘 询 数据 源 中 的 一 个 对 象 集合 (从 技术 角度 看 ， 它 并 不 是 一 个 
集合 ， 只 是 看 起 来 像 是 集合 而 已 )。 


注意 : 

如 果 布 望 了 解 细节 ， 查 询 结果 将 是 实现 了 正 numerable<T>= 接 口 的 类 型 。 正 numerable & dj 45 +4 T 03 £465 
(<T>) 表 示 这 是 一 个 泛 型 类 型 。 泛 型 详 见 第 12 Ë. 

在 上 例 中 ， 编 译 器 创建 了 一 个 特殊 的 LINQ 数据 类 型 ， 它 提供 了 字符 串 的 有 序列 表 ( 因 为 数据 源 是 一 个 字符 
BE). 
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另外 ，queryResult 名 称 是 随意 指定 的 ， 可 以 把 结果 命名 为 任何 名 称 ， 例 如 ，namesBeginningWiths 或 者 在 
程序 中 有 意义 的 其 他 名 称 。 


22.32 ”指定 数据 源 : from FA 
LINQ 查询 的 下 一 部 分 是 from 子 句 ， 它 指定 了 要 查询 的 数据 : 
from n in names 
本 例 中 的 数据 源 是 前 面 声明 的 字符 串 数组 names. at n 只 是 数据 源 中 某 一 元 素 的 代表 ， 类 似 于 foreach if 


句 后 面 的 变量 名 。 指 定 from 子 可 ， 就 可 以 只 查找 集合 的 一 个 子 集 ， 而 不 必 帮 代 所 有 的 元 素 。 
WENA, LINQ 数据 源 必 须 是 可 枚 举 的 一 一 即 必 须 是 数组 或 集合 ， 以 便 从 中 选择 出 一 个 或 多 个 元 素 。 


注意 : 


可 枚 举 意味 着 数据 源 必 须 支持 IEnumerable<T> 接 口 ， 所 有 C# 数 组 或 项 集合 都 支持 这 个 接口 。 
数据 源 不 能 是 单个 值 或 对 象 ， 例 如 ， 单 个 int 变量 。 如 果 只 有 一 项 ， 就 没 必 要 查询 了 。 


22.33 指定 条 件 : where $4) 
在 LINQ 查询 的 下 一 部 分 ， 可 以 用 where 子 句 指定 查询 的 条 件 ， 如 下 所 示 : 


Where n.StartsWith("S") 
可 以 在 where 子 句 中 指定 能 应 用 于 数据 源 中 各 元 素 的 任意 布尔 (true 或 false) 表 达 式 。 实 际 上 ，where 子 句 是 
可 选 的 ， 甚 至 可 以 忽略 ， 但 大 多 数 情况 下 ， 都 要 指定 where 条 件 ， 把 结果 限制 为 我 们 需要 的 数据 。where 子 句 
PKA LINQ 中 的 限制 运 复 符 ， 因 为 它 限制 了 查询 的 结果 。 
这 个 示例 指定 name 字符 串 以 字母 S 开 类, 还 可 以 给 字符 串 指定 其 他 条 件 ,例如 , 长度 超 过 10(where n.Length > 
10) 或 者 包含 Q(where n.Contains("Q")). 


22.34 选择 元 素 : select FA 
最 后 ，select 子 句 指定 结果 集中 包含 哪些 元 时。select 子 句 如 下 所 示 : 


select n 
select 子 句 是 必需 的 ， 因 为 必须 指定 结果 集中 有 哪些 元 素 。 这 个 结果 集 并 不 是 很 有 趣 ， 因 为 在 结果 集 的 每 
个 元 素 中 都 只 有 一 项 name。 如 果 结 果 集 中 有 比较 复杂 的 对 象 ， 使 用 select 子 句 的 有 效 性 就 比较 明显 ， 不 过 我 们 
还 是 首先 完成 这 个 示例 。 


22.35 完成 : 使 用 foreach 循环 


现在 输出 查询 的 结果 ,与 把 数组 用 作 数 据 源 一 样 , 像 这 样 的 LINQ 查询 结果 是 可 以 枚 举 的 , 即 可 以 用 foreach 
be IA RAR: 
WriteLine ("Names beginning with S:"); 
foreach (var item in queryResults) { 
WriteLine (item); 
} 
FEA BI, MEy 5 个 名 称 : Smith. Smythe. Small. Singh 和 Samba， 所 以 它们 会 显示 在 foreach 循 


环 中 。 


223.6 ”延迟 执行 的 查询 
foreach 循环 实际 上 并 不 是 LINQ HAR E HIEXST AR. BA foreach 结构 并 不 是 LINQ 的 一 部 分 ， 
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但 它 是 实际 执行 LINQ 碍 询 的 代码 。 碍 询 结果 变量 仅 保 存 了 执行 查询 的 一 个 计划 ， 在 访问 查询 结果 之 前 ， 并 没 
有 提取 LINQ 数 据 ， 这 称 为 得 询 的 延迟 执行 或 迟 绥 执行。 生成 结果 序 列 ( 即 列表 ) 的 查询 都 要 延迟 执行 。 
现在 回头 来 看 代码 。 由 于 输出 了 结果 ， 所 以 程序 结束 : 


Write ("Program finished, press Enter/Return to continue:"); 
ReadLine(); 


这 些 代 码 仅 确保 在 按 下 一 个 键 (其 至 可 以 按 下 FS 键 ， 而 不 是 Ctr FS 组 合 
显示 在 屏 医 上 。 在 大 多 数 其 他 LINQ 示例 中 也 使 用 这 种 结构 。 


键 ) 之 前 ， 控 制 台 程序 的 结果 始终 


22.4 LINO 方法 语法 


使 用 LINQ 完成 同一 任务 有 多 种 方式 ， 这 与 编程 时 一 样 。 如 前 所 述 ， 前 面 的 示例 古 用 LINQ 碍 询 语法 编写 
的 ， 下 一 个 示例 是 用 LINQ 的 方法 语法 (也 称 为 显 式 语法 ， 但 这 里 使 用 “方法 语法 ”这 个 术语 ) 编 写 的 相同 程序 。 


22.4.1 LINQ 扩展 方法 


LINQ 实现 为 一 系列 扩展 方法 ， 用 于 集合 、 数 组 、 查 询 结 果 和 其 他 实现 了 IEnumerable<T> 接 口 的 对 象 。 
在 Visual Studio IntelliSense 特性 中 可 以 看 到 这 些 方法 。 例 如 ， 在 Visual Studio 2017 中 打开 FirstLINQquery 程 
序 中 的 Program.cs 文件 ， 在 name 数组 的 下 面 输入 对 访 数 组 的 一 个 新 引用 : 

string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", "Small", 

"Ruiz", “Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 

输入 names 后 面 的 句点 后 ， 就 会 看 到 Visual Studio IntelliSense 特性 列 出 的 可 用 于 names 的 方法 。 

Where<T> 方 法 与 大 多 数 其 他 方法 都 是 扩展 方法 (在 Where<T> 方 法 的 右边 显示 了 一 个 文档 说 明 ， 它 以 
extension F$). HAREM f using System.Linq 指令 ，Where<T>、Union<T>、Take<I> 和 大 多 数 其 
他 方法 就 会 从 列表 中 消失 。 上 一 个 示例 使 用 的 from..where..select 查询 表达 式 由 C# 编 译 器 转换 为 这 些 方法 的 一 
系列 调用 。 使 用 LINQ 方法 语法 时 ， 就 直接 调用 这 些 方 法 。 


224.2 查询 语法 和 方法 语法 

查询 语法 是 在 LINQ 中 编写 查询 的 首选 方式 ， 因 为 它 一 般 更 容易 理解 ， 最 常见 的 查询 使 用 它们 也 更 简单 。 
但 是 , 一 定 要 基本 了 解 方法 语法 ， 因 为 一 些 LINQ 功能 不 能 通过 查询 语法 来 使 用 ， 或 者 使 用 方法 语法 比较 简单 。 

注意 : 

Visual Studio 2017 联机 帮助 建议 尽量 使 用 查询 语法 ， 仅 在 需要 时 使 用 方法 语法 。 

本 章 主 要 使 用 查询 语法 ， 但 会 指出 需要 方法 语法 的 场合 ， 并 说 明 如 何 使 用 方法 语法 来 解决 问题 。 

大 多 数 使 用 方法 语法 的 LINQ 方法 都 要 求 传 送 一 个 方法 或 函数 ， 来 计算 查询 表达 式 。 方 法 /函数 参数 以 委托 
形式 传送 ， 它 一 般 引 用 一 个 匿名 方法 。 

LINQ 很 容易 完成 这 个 传送 任务 。 使 用 Lambda 表达 式 就 可 以 创建 方法 /函数 ， 它 以 优雅 的 方式 封装 委托 :。 
22.4.3 Lambda 表达 式 


Lambda 表达 式 很 容易 随时 创建 在 LINQ 俘 询 中 使 用 的 方法 。 它 使 用 -> 操作 从， 它 在 一 行 代 码 中 声明 方法 
的 参数 后 跟 方法 的 逻辑 。 


注意 : 
“Lambda 表达 式 ” 这 个 词 来 自 微 积分 ， 这 是 编程 语言 理论 中 的 一 个 重要 的 数学 领域 。 如 果 读 者 擅长 数学 ， 
可 以 查 一 下 。 幸 好 ， 在 C# 中 使 用 Lambda 不 需要 数学 知识 ! 
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例如 ， 下 面 的 Lambda 表达 式 : 

n =>mn<0 

这 个 语句 声明 了 一 个 带 单一 参数 n 的 方法 。 如 果 n 小 于 0， 该 方法 就 返回 tue， 否 则 返回 false。 这 是 非常 
简单 的 。 不 需要 方法 名 、 返 回 语句 ， 也 不 需要 用 花 括 号 将 任何 代码 括 起 来 。 

像 这 样 返回 true / false 值 是 LINQ 的 Lambda 表达 式 中 的 方法 常用 的 方式 ,但 这 不 是 必需 的 。 例 如 ， 下 面 的 
Lambda 表达 式 创建 了 一 个 方法 ， 它 返回 两 个 变量 之 和 。 这 个 Lambda 表达 式 使 用 了 多 个 参数 : 

(a, b) => a+b 

这 个 语句 声明 一 个 带 两 个 参数 和 b 的 方法 。 方 法 逻辑 返回 a 和 b 的 和 。 不 必 声 明 a RI 的 类 型 是 什么 。 
它们 可 以 是 int、double 或 sring。c# 编 译 器 会 推断 出 类 型 。 

最 后 考虑 下 面 的 Lambda 表达 式 : 

n => n.StartsWith("S") 


如 果 了 以 字母 $ 开头 ， 这 个 方法 就 返回 true, AURE false。 下 一 个 示例 将 更 消 楚 地 说 明 这 一 后 。 


试 一 试 ” 使 用 LINQ 方法 语法 和 Lambda 表达 式 :BeginningCSharp7 22 4 MethodSyntax\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) 可 以 修改 前 面 的 示例 ， 或 在 C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程序 
BeginningCSharp7 22 4 MethodSyntax。 打 开 主 源 文 件 Program.cs. 

(2) Visual Studio 2017 会 自动 在 Program.cs 中 包含 Linq 名 称 空间 : 

using System. Ling; 


(3) É Program.cs 的 Main0 方 法 中 添加 如 下 代码 : 


static void Main(string[] args) 
{ 
string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", 
"Small", "Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 
var queryResults = names.Where(n => n.StartsWith("S")); 
WriteLine ("Names beginning with 5:"); 
foreach (var item in queryResults) { 
WriteLine (item); 
} 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine (); 
} 
(4) 编 详 并 执行 程序 (可 按 下 FS 键 )。 结 果 也 是 以 S 开头 的 names 列表 ， 且 按照 它们 在 数组 中 声明 的 顺序 排 
列 ， 如 下 所 示 : 


Names beginning with 5: 

Smith 

smythe 

small 

Singh 

Samba 

Program finished, press Enter/Return to continue: 


示例 说 明 
与 前 面 一 样 ，Visual Studio 2017 会 自动 引用 System.Linq 名 称 空 间 : 
using System.Ling; 


再 次 声明 和 初始 化 names 数组 ， 创 建 相 同 的 源 数据 : 


string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", "Small", "Ruiz", 
"Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 


LINQ 查询 是 不 同 的 ， 它 现 在 是 Where(0) 方 法 的 调用 ， 而 不 是 查询 表达 式 : 
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var queryResults = names.Where(n => n.StartsWith("S")); 

C# 编 译 占 把 Lambda 表达 式 n => n.Starts With("S")) EA TE 4 IK, Where(fE names 2X2H IN BES 70K 
上 执行 这 个 方法 。 如 果 Lambda 表达 式 给 某 个 元 素 返 回 ttme， 该 元 素 就 包含 在 Where0 返 回 的 结果 集中 。 CHi 
详 右 从 输入 数据 源 (这 里 是 names 数组 ) 的 定义 中 推 新 ， 该 Where0 方 法 应 把 string 作为 每 个 元 素 的 输入 类 型 。 

许多 工作 都 是 在 一 行 代码 中 完成 的 。 对 于 像 这 样 最 简单 的 查询 ， 方 法 语法 要 比 得 询 语 法 更 加 简短 ， 因 为 不 
需要 from 或 select FAJ, (AAS Aria AB EX ERR. 

示例 的 剩余 部 分 与 前 面 的 代码 相同 一 一 在 foreach Ji} Fea fri AG FP, MEETER MT SG 
毕 前 看 到 结果 : 


foreach (var item in queryResults) { 
WriteLine (item); 


} 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine (); 


这 里 不 重复 说 明 这 些 代码 行 ， 因 为 本 章 第 一 个 示例 后 面 的 “示例 说 明 ” 已 经 解释 过 了 。 下 面 继续 研究 如 何 
使 用 LINQ 的 更 多 功能 。 


225 ”排序 查询 结果 


用 where 子 句 (或 者 Where0 方 法 调用 ) 找 到 了 感 兴趣 的 数据 后 ，LINQ 还 可 以 方便 地 对 得 到 的 数据 执行 进 一 
步 处 理 ， 例 如 ， 重 新 排列 结果 的 顺序 。 下 面 的 示例 将 按 字母 顺序 给 第 一 个 查询 的 结果 排序 。 


试 一 试 ” 给 查询 结果 排序 : BeginningCSharp7_22 5 OrderQueryResults\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 。 
(1) 可 以 修改 QuerySyntax 示例 , 或 者 在 C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程 
序 项 目 BeginningCSharp7 22 5 OrderQueryResults. 
(2) 打开 主 源 文件 Program.cs, 与 以 前 一 样 , Visual Studio 2017 4 FH z/Jf£ Program.cs 中 包含 using System. Linq: 
名 称 空间 指令 。 
(3) 在 Program.cs 的 Main0 方 法 中 添加 如 下 代码 : 
static void Main(string[] args) 
{ 
string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", 
"Small", "Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 
var queryResults = 
from n in names 
where n.StartsWith("S") 
orderby n 
select n; 
WriteLine("Names beginning with S ordered alphabetically:"); 
foreach (var item in queryResults) { 
WriteLine (item); 
} 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine(); 


| 
(4) 编译 并 执行 程序 。 结 果 是 以 S 开头 的 names 列表 ， 且 按 字母 顺序 排序 ， 如 下 所 示 : 


Names beginning with S: 

Samba 

Singh 

Small 

Smith 

Smythe 

Program finished, press Enter/Return to continue: 


示例 说 明 
这 个 程序 与 前 一 个 程序 几乎 相同 ， 只 是 在 查询 语句 中 增加 了 一 行 代 码 : 
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var queryResults = 
from n in names 
where n.StartsWith("s") 
orderby n 
select n; 


22.6 orderby +4] 


orderby 子 句 如 下 所 示 : 


orderby n 


Hj where 1^5J— FE, orderby 子 句 也 是 可 选 的 .只 要 添加 一 行 , BA) DONT AE A A REAP f AMEE LINQ 
时 ， 根 据 选 择 实现 的 排序 复 法 ， 需 要 箱 外 编写 至 少 几 行 代码 ， 还 可 能 需要 添加 几 个 方法 或 集合 来 存储 重新 排序 
的 结果 。 如 果 有 多 个 需要 排序 的 类 型 ， 就 需要 为 每 个 类 型 实现 一 系列 排序 方法 。 而 使 用 LINQ 不 需要 做 这 些 工 
作 ， 只 需要 在 查询 语句 中 添加 一 条 子 句 即 可 。 

orderby 子 句 默认 为 升序 (A 到 Z)， 但 可 以 添加 descending 关键 字 ， 以 便 指定 为 降 订 (Z 到 A): 


orderby n descending 


这 会 使 示例 的 结 末 变 成 : 
smythe 

smith 

small 

Singh 

Samba 


男 外 ， 可 以 按照 任 童 表达 式 进行 排序 ， 而 不 必 午 新 编写 但 询 。 例 如 ， 要 按照 姓名 中 的 最 后 一 个 字母 排序 ， 
而 不 是 按 一 般 的 字母 顺序 排序 ， 束 只 需要 添加 如 下 orderby 178): 


orderby n.Substring(n.Length - 1) 


结果 如 下 : 
Samba 
smythe 
Smith 
Singh 
Small 


注意 : 
最 后 一 个 字母 按 字 母 顺 友 排 上 友 (a， Cs h, h, ])。 但 这 个 执行 过 程 依赖 于 实现 方式 ,， 即 无 法 保证 除了 orderby 
子 句 中 指定 的 内 容 之 外 的 其 他 字母 的 顺序 。 由 于 仅 考 虑 最 后 一 个 字母 ， 因 此 在 本 例 中 ，Smith Æ Singh 的 前 面 . 


22.7 ”查询 大 型 数据 集 
LINQ 语法 非常 好 ， 但 其 作用 是 什么 ? 我 们 只 要 得 看 源 数组 ， 就 可 以 看 出 需要 的 结果 ， 为 什么 要 得 询 这 种 


一 有 眼 就 能 看 出 结果 的 数据 源 呢 ?如 前 所 述 ， 有 时 查询 的 结果 不 那么 明显 。 在 下 例 中 ， 就 创建 了 一 个 非 第 大 的 数 
字数 组 ， 并 用 LINQ 查询 它 。 


试 一 试 ”查询 大 型 数据 集 : BeginningCSharp7 22 6 LargeNumberQuery\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 。 
(1) 在 C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 22 6_ 
LargeNumberQuery。 与 以 前 一 样 ， 创 建 项 目 时 ，Visual Studio 2017 会 目 动 在 Program.cs 中 包含 Linq 名 称 空间 。 


using System; 
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using System.Collections.Generic; 
using System.Ling; 

using System.Text; 

using static System.Console; 


(2) 在 Main0 方 法 中 添加 如 下 代码 : 


static void Main(string[] args) 
{ 
int[] numbers = GenerateLotsOfNumbers (12045678) ; 
Var queryResults = 
from n in numbers 
where n < 1000 
select n 


WriteLine ("Numbers less than 1000:"); 

foreach (var item in queryResults) 

{ 
WriteLine (item); 

} 

Write ("Program finished, press Enter/Return to continue:"); 

ReadLine () ; 
} 


(3) 添加 如 下 方法 ， 生 成 一 个 随机 数列 表 : 


private static int[] GenerateLotsOfNumbers (int count) 


{ 
Random generator = new Random(0); 
int[] result = new int [count]; 
for (int i = 0; i < count; i++) 

result[i] = generator.Next(); 

} 
return result; 

} 


(4) 编译 并 执行 程序 。 结 果 是 一 个 小 于 1000 的 数字 列表 ， 如 下 所 示 : 


Numbers less than 1000: 
714 


584 
Program finished, press Enter/Return to continue: 


示例 说 明 
与 前 面 一 样 ， 第 一 步 是 引用 System .Linq 名 称 空间 ， 这 是 在 创建 项 目 时 由 Visual Studio 2017 目 动 引用 的 : 


using System.Linq; 


接着 创建 一 些 数 据 ， 为 此 ， 本 例 中 创建 并 调用 了 GenerateLotsOfNumbers0) 方 法 : 


int[] numbers = GenerateLotsofNumbers (12345678); 
private static int[] GenerateLotsOfNumbers (int count) 


{ 
Random generator = new Random(0); 
int[] result = new int[count]; 
for (int i = 0; i < count; i++) 

result[i] = generator.Next(); 

} 
return result; 

} 


这 不 是 一 个 小 数据 集 ， 数 组 中 有 1200 万 个 数字 ! 在 本 章 最 后 的 一 个 习题 中 ， 需 要 修改 传递 给 
GenerateLotsOfNumbers0 〇 方法 的 size 参数 ， 生 成 数量 不 同 的 随机 数 ， 看 看 这 会 对 得 询 结果 有 什么 影响 。 在 做 习 
题 时 会 看 到 ， 这 里 的 size 参数 12 345 678 非 贡 大， 足以 生成 一 些小 于 1000 的 随机 数 ， 从 而 获得 为 第 一 个 坦 询 
显示 的 结果 。 

数值 应 随机 分 布 在 有 符号 的 整数 范围 内 (从 0 到 超过 20 亿 )。 用 种 子 值 0 创建 随机 数 生成 器 ， 可 以 确保 每 次 
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创建 相同 的 随机 数 集 合 ， 这 是 可 以 重复 的 ， 所 以 会 获得 与 此 处 相同 的 查询 结 朱 ， 但 在 答 试 一 些 得 询 之 前 ， 并 不 
知道 查询 结果 是 什么 。 而 LINQ 使 这 些 查询 很 容易 编写 。 
得 询 语句 本 号 类 似 于 前 面 用 于 names 数组 的 查询 ， 也 是 选择 某 些 满足 条 件 的 数字 (这 里 是 数字 小 于 1000): 
Var i ea re dtm 


where n < 1000 
select n 


这 次 不 需要 orderby 子 句 ， 但 处 理 时 间 稍 长 (对 于 这 个 查询 ， 处 理 时 间 的 变化 不 太 明显 ， 但 下 一 个 示例 会 改 
变 选 择 条 件 ， 处 理 时 间 的 变化 就 比较 明显 了 )。 

用 foreach 语句 输出 查询 的 结 朱 ， 与 前 面 的 示例 相同 : 

WriteLine ("Numbers less than 1000:"); 

foreach (var item in queryResults) { 


WriteLine (item); 


同样 ， 将 结果 输出 到 控制 人 台 上 ， 并 读 取 一 个 字符 以 暂 集 输出: 


Write ("Program finished, press Enter/Return to continue:"); 
ReadLine(); 


后 面 所 有 的 示例 都 有 暂停 代码 ， 但 不 再 列 出 ， 因 为 每 个 示例 的 暂停 代码 都 相同 。 
使 用 LINQ， 可 以 很 容易 地 修改 衣 询 条 件 ， 以 便 演 示 数 据 集 的 不 同 特 性 。 但 是 ， 根 据 胡 询 返回 的 结果 数 ， 
每 次 都 输出 所 有 的 结果 是 没有 意义 的 。 下 一 节 将 说 明 LINQ 提供 的 聚合 运算 和 从 是 如 何 处 理 这 种 情况 的 。 


228 ”使 用 聚合 运算 符 


查询 给 出 的 结果 党 超出 了 我 们 的 期 望 。 如 果 要 修改 大 数 查询 程序 的 条 件 ， 只 需要 列 出 大 于 1000 的 数字 , 而 
不 是 小 于 1000 的 数字 ， 这 会 得 到 非常 多 的 查询 结果 ， 数 字 会 不 停 地 显示 出 来 。 

LINQ 提供 了 一 组 聚合 运算 符 ， 可 用 于 分 析 查 询 结 果 ， 而 不 必 迁 代 所 有 结果 。 表 22-1 列 出 的 聚合 运算 符 是 
数字 结果 集 最 常用 的 运算 符 , 例如 ， 大 数 查询 的 结果 就 常用 这 些 聚 合 运算 符 ， 如 果 读者 用 过 数据 库 查询 语言 (如 
SQD)， 就 会 十 分 熟悉 这 些 运算 符 。 


#221 数字 结果 的 聚合 运算 符 


m 算 Wu 说 明 
Count() 结果 的 个 数 
Min() 结果 中 的 最 小 值 
Max() 结果 中 的 最 大 值 
Average() 数字 结果 的 平均 值 
Sum() 所 有 数字 结果 的 总 和 


还 有 更 多 的 聚合 运算 从， 如 Aggregate 中 ， 它 们 可 以 执行 代码 ， 并 允许 你 目 行 编写 聚合 函数 。 但 这 些 都 用 于 
局 级 用 尸 ， 超 出 了 本 书 的 讨论 范围 。 


注意 : 
聚合 运算 符 返 回 一 个 简单 的 标量 类 型 ， 而 不 是 一 系列 结果 ， 所 以 使 用 它们 会 强制 立即 执行 查询 ， 而 不 是 延 
迟 执行 。 


下 面 的 示例 修改 大 数 查 询 ， 并 使 用 聚合 运算 符 和 LINQ 分 析 大 数 香 询 的 大 于 版 本 中 的 结果 集 。 
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i—i ”数字 聚 合 运算 付 : BeginningCSharp/ 22 7 NumericAggregates\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) 对 于 这 个 示例 ， 可 以 修改 前 面 的 LargeNumberQuery 示例 ， 或 在 C:\BeginningCSharp7\Chapter22 目录 中 
创建 一 个 新 的 控制 台 项 目 BeginningCSharp7 22 7 NumericAggregates. 

(2) 与 以 前 一 样 ， 创 建 项 目 时 ，Visual Studio 2017 会 自动 在 Program.cs 中 包含 Ling 名 称 空间 。 只 需要 修改 
Main0 方 法 ， 如 下 面 的 代码 和 本 示例 其 余部 分 所 示 。 与 上 一 个 例子 一 样 ， 这 个 查询 也 不 使 用 orderby 子 句 。 但 是 
where 子 句 中 的 条 件 与 前 一 个 例子 相反 (数字 应 大 于 1000(m>1000)， 而 不 是 小 于 1000). 


static void Main(string[] args) 
{ 
int[] numbers = GenerateLotsOfNumbers (12345678); 
WriteLine ("Numeric Aggregates"); 
var queryResults = 
from n in numbers 
where n > 1000 
select n 


WriteLine ("Count of Numbers > 1000"); 
WriteLine(queryResults.cCount()); 
WriteLine("Max of Numbers > 1000"); 
WriteLine (queryResults.Max()); 

WriteLine ("Min of Numbers > 1000"); 
WriteLine(queryResults.Min()); 
WriteLine("Average of Numbers > 1000"); 
WriteLine (queryResults.Average()); 
WriteLine ("Sum of Numbers > 1000"); 
WriteLine (queryResults.Sum(n => (long) n)); 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine(); 


} 
(3) 添加 上 例 中 使 用 的 GenerateLotsOfNumbers0 方 法 (如 果 不 存 在 ): 


private static int[] GenerateLotsOfNumbers (int count) 


{ 
Random generator = new Random(0); 
int[] result = new int[count]; 
for (int 1 = 0; i < count; i++) 

result[i] = generator.Next(); 

} 
return result; 

} 


(4) 编译 并 执行 程序 ， 显 示 个 数 、 最 小 值 、 最 大 值 和 平均 值 ， 如 下 所 示 : 


Numeric Aggregates 

Count of Numbers > 1000 
12345671 

Maximum of Numbers > 1000 
2147483591 

Minimum of Numbers > 1000 
1034 

Average of Numbers > 1000 
1073643807.50298 

Sum of Numbers > 1000 
13254853218619179 
Program finished, press Enter/Return to continue: 


这 个 查询 生成 的 结果 数量 超过 上 一 个 例子 (超过 1200 万 )。 在 这 个 结果 集 上 使 用 orderby， 对 性 能 会 有 显著 
影响 。 结 果 集中 的 最 大 值 超过 20 亿 ， 最 小 值 刚 刚 大 于 1 000。 平 均值 大 约 是 10 亿 ， 接 近 数 字 范 围 的 中 间 值 。 看 
来 ，Random0 函 数 可 以 生成 均匀 分 布 的 数字 。 

示例 说 明 

程序 的 第 一 部 分 与 上 一 个 例子 完全 相同 , 也 是 引用 System.Linq 名 称 空间 , 然后 用 GenerateLotsOfNumbers0 
方法 生成 源 数据 : 


int[] numbers = GenerateLotsOfNumbers(12345678); 
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查询 也 与 上 一 个 例子 相同 ， 只 是 把 where 条 件 从 小 于 改 为 大 于 : 
Var queryResults = 
from n in numbers 
where n > 1000 
select n; 


如 前 所 述 ， 使 用 大 于 条 件 的 这 个 得 询 生成 的 结果 远 远 多 于 小 于 得 询 ( 对 这 个 数据 集 而 言 )。 使 用 聚合 运 复 符 
可 以 分 析 查 询 结 果 , 而 不 必 输 出 每 个 结果 , 或 者 在 foreach 循环 中 比较 它们 。 每 个 聚合 运算 符 都 类 似 于 一 个 可 在 
结果 集 上 调用 的 方法 ， 也 类 似 于 在 集合 类 型 上 调用 的 方法 。 

下 和 面 看 一 下 每 个 聚合 运算 符 的 用 法 : 

e Count(): 


WriteLine ("Count of Numbers > 1000"); 
WriteLine (queryResults.Count ()); 


Count0 返 回 查 询 结 果 中 的 行 数 ， 在 这 个 例子 中 是 12 345 671 行 。 
® Max(): 


WriteLine ("Max of Numbers > 1000"); 
WriteLine (queryResults.Max()); 


Max0 返 回 查 询 结果 中 的 最 大 值 ， 在 这 个 例子 中 是 大 于 20 亿 的 一 个 数 2 147 483 591， 它 非常 接近 int 的 最 
大 值 (intMaxValue 或 2 147 483 647)。 
e Min(): 


WriteLine("Min of Numbers » 1000"); 
WriteLine (queryResults.Min()); 
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e Average(): 


WriteLine("Average of Numbers » 1000"); 
WriteLine (queryResults.Average ()); 


Average0 返 回 查询 结果 中 的 平均 值 ， 在 这 个 例子 中 是 1 073 643 807.502 98， 它 非常 接近 1 000 到 20 亿 的 值 
范围 的 中 间 值 。 对 于 随机 的 大 数 而 言 ， 这 个 中 间 值 没有 什么 意义 ， 但 说 明了 可 以 对 查询 结果 进行 分 析 。 本 章 最 
后 一 部 分 将 使 用 这 些 运算 符 对 面向 业务 的 数据 进行 更 贴近 实际 的 分 析 。 

e Sum(): 


WriteLine("Sum of Numbers > 1000"); 
WriteLine(queryResults.Sum(n => (long) n)); 


在 此 给 Sum0 方 法 调用 传送 了 Lambda 表达 式 n—(long) n， 以 获得 所 有 数字 的 总 和 。 与 Countü. Min(. 
Max0 等 相同 ，Sum0 有 一 个 无 参数 的 重 载 版 本 ， 但 使 用 Sum0 方 法 的 这 个 版 本 会 导致 溢出 错误 ， 因 为 数据 集中 
的 数字 太 多 ， 它 们 的 总 和 太 大 ， 不 能 放 在 Sum0 方 法 的 无 参数 重 载 版 本 返回 的 标准 32 位 int 中 。Lambda 表达 式 
允许 将 Sum0 方 法 的 结果 转换 为 64 位 长 整数 ， 它 可 以 保存 超过 13 X 10° 的 数字 13 254 853 218 619 179, 而 不 出 
Pym tH» Lambda 表达 式 人 允许 方便 地 执行 这 个 转换 。 


Count0 返 回 32 位 int. LINQ 还 提供 了 一 个 LongCount0 方 法 ， 它 在 64 位 整数 中 返回 查询 结果 的 个 数 。 但 
有 一 个 特殊 情况 : 如 果 需 要 数字 的 64 位 版 本 , 所 有 其 他 运算 符 都 需要 一 个 Lambda 表达 式 或 调用 一 个 转换 方法 。 


22.9 ” 单 值 选择 查询 


在 SQL 数据 查询 语言 中 , RIAR AKAME SELECT DISTINCT 查询 , 该 但 询 可 搜索 数据 中 的 唯一 
值 ， 也 就 是 说 ， 值 是 不 重复 的 。 这 是 使 用 公 询 时 的 一 个 第 见 需求 。 
假定 需要 和 在 前 面 示例 使 用 的 顾客 数据 中 得 找 不 同 的 区 域 ， 由 于 在 这 些 数据 中 没有 单独 的 区 域 列 表 ， 所 以 需 
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要 从 顾客 列表 中 找 出 唯一 的 、 不 重复 的 区 域 列 表 。LINQ 提供 了 Distinct0 方 法 ， 以 便 找 出 这 些 数据 ， 如 下 面 的 
示例 所 示 。 


试 一 试 “投影 一 一 单 值 选 择 查 询 : BeginningCSharp/7_22 8 SelectDistinctQuery\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) f£ C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 22 8 _ 
SelectDistinctQuery. 

(2) 输入 如 下 代码， 创建 Customer 类 ， 初 始 化 customers 列表 (List<Customer> customers): 


class Customer 
{ 
public string ID { get; set; } 
public string City { get; set; } 
public string Country { get; set; } 
public string Region { get; set; } 
public decimal Sales { get; set; } 


public override string ToString() 
{ 
return "ID: " + ID + " City: ™ + City + 
" Country: ™ + Country + 
" Region: " + Region + 
" Sales: " + Sales; 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
List<Customer> customers = new List<Customer> { 
new Customer { ID="A", City="New York", Country="USA", 
Region="North America", Sales=9999}, 
new Customer { ID="B", City="Mumbai", Country="India", 
Region-"Asia", Sales-8888], 
new Customer { ID-"C", City-"Karachi", Country-"Pakistan", 
Region-"Asia", Sales=7777}, 
new Customer { ID-"D", City="Delhi", Country-"India", 
Region-"Asia", Sales-6666], 
new Customer { ID-"E", City-"Sào Paulo", Country="Brazil", 
Region-"South America", Sales-5555 ], 
new Customer { ID-"F", City-"Moscow", Country-"Russia", 
Region-"Europe", Sales-4444 ], 
new Customer { ID-"G", City-"Seoul", Country-"Korea", 
Region-"Asia", Sales=3333 }, 
new Customer { ID="H", City="Istanbul", Country="Turkey", 
Region="Asia", Sales=2222 }, 
new Customer { ID="I", City="Shanghai", Country="China", 
Region="Asia", Sales=1111 }, 
new Customer { ID-"J", City="Lagos", Country-"Nigeria", 
Region-"Africa", Sales-1000 }, 
new Customer { ID="K", City-"Mexico City", Country-"Mexico", 
Region-"North America", Sales=2000 ], 
new Customer { ID-"L", City-"Jakarta", Country-"Indonesia", 
Region-"Asia", Sales=3000 }, 
new Customer { ID="M", City="Tokyo", Country="Japan", 
Region="Asia", Sales=4000 }, 
new Customer { ID="N", City="Los Angeles", Country="USA", 
Region="North America", Sales=5000 }, 
new Customer { ID-"O", City="Cairo", Country-"Egypt", 
Region="Africa", Sales=6000 }, 
new Customer { ID="P", City="Tehran", Country="Iran", 
Region="Asia", Sales=7000 }, 
new Customer { ID-"Q", City-"London", Country="UK", 
Region="Europe", Sales=8000 }, 
new Customer { ID-"R", City-"Beijing", Country-"China", 
Region="Asia", Sales=9000 }, 
new Customer { ID-"S", City-"Bogotá", Country="Colombia", 
Region="South America", Sales=1001 }, 
new Customer { ID="T", City="Lima", Country="Peru", 
Region="South America", Sales=2002 } 
> 


(3) 在 Main0 方 法 的 customers ZI JE Jc. dí NCC) fri, fn PW: 
var queryResults = customers.Select(c => c.Region).Distinct(); 


(4) 完成 Main0 方 法 的 其 余 代 码 ， 如 下 所 示 : 
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foreach (var item in queryResults) 


{ 
} 


Write("Program finished, press Enter/Return to continue:"); 
ReadLine (); 


(5) 编译 并 执行 程序 ， 结 果 显 示 的 是 顾客 所 在 的 唯一 区 域 ， 如 下 所 示 : 


North America 

Asia 

South America 

Europe 

Africa 

Program finished, press Enter/Return to continue: 


WriteLine (item); 


示例 说 明 

Customer 类 和 customers 列表 的 初始 化 与 前 面 例子 中 的 相同 。 在 查询 语句 中 ， 调 用 了 Select0 方 法 ， 用 一 个 
简单 的 Lambda 表达 式 从 Customer 对 象 中 选择 区 域 ， 再 调用 Distinct0， 从 Select0 中 返回 唯一 的 结果 : 

var queryResults = customers.Select(c => c.Region) .Distinct (); 

只 能 在 方法 语法 中 使 用 Distinct0， 所 以 使 用 方法 语法 调用 Select0。 还 可 以 调用 Distinct0 来 修改 在 查询 语法 
中 创建 的 查询 : 

var queryResults = (from c in customers select c.Region).Distinct(); 

查询 语法 由 C# 编 译 器 转换 为 方法 语法 中 的 同系 列 LINQ 方法 调用 ， 所 以 如 果 可 以 改进 可 读 性 和 代码 风格 ， 
可 以 混合 和 匹配 它们 。 


22.10 ”多 级 排序 


处 理 了 市 多 个 属性 的 对 象 后 ， 就 要 考虑 男 一 种 情形 了 : 按 一 个 字段 给 查询 结果 排序 是 不 够 的 ， 需 要 奋 询 顾 
客 ， 并 按照 区 域 使 结果 以 字母 顺序 排列 ， 再 按 区 域 中 的 国家 或 城市 名 称 以 字母 顺序 排序 。 使 用 LINQ， 可 方便 
地 完成 这 个 任务 ， 如 下 面 的 示例 所 示 。 


试 一 试 ”多 级 排序 : BeginningCSharp7 22 9 MultiLevelOrdering\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 
(1) 修改 前 面 的 示例 BeginningCSharp7 22 8 SelectDistinctQuery, 或 在 C:\BeginningCSharp7\Chapter22 目录 
中 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 22 9 MultiLevelOrdering. 
(2) 如 BeginningCSharp7 22 8 SelectDistinctQuery 示例 所 示 ， 人 创建 Customer 类 并 初始 化 customers 列表 
(List<Customer> customers)， 这 些 代码 与 前 面 示例 中 的 代码 完全 相同 。 
(3) 在 Main0 方 法 的 customers 列表 急 始 化 之 后 ， 输 入 如 下 所 示 的 得 询 : 
gui ceci pci AR 


orderby c.Region, c.Country, c.City 
select new { c.ID, c.Region, c.Country, c.City } 


(4) 结果 处 理 循 环 和 Main0 方 法 的 其 余 代 码 与 前 面 例 子 中 的 相同 。 
(5) 编译 并 执行 程序 ， 从 所 有 顾客 中 选择 出 来 的 属性 将 先 按 区 域 排序 ， 再 按 国 家 排序 ， 最 后 按 城 市 排序 ， 
如 下 所 示 : 


{ ID = O, Region = Africa, Country = Egypt, City = Cairo } 

{ ID = J, Region = Africa, Country = Nigeria, City = Lagos } 

{ ID = R, Region = Asia, Country = China, City = Beijing } 

{ ID = I, Region = Asia, Country = China, City = Shanghai } 

{ ID = D, Region = Asia, Country = India, City = Delhi } 

{ ID = B, Region = Asia, Country = India, City = Mumbai } 

{ ID = L, Region = Asia, Country = Indonesia, City = Jakarta } 
{ ID = P, Region = Asia, Country = Iran, City = Tehran } 
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{ ID = M, Region = Asia, Country = Japan, City = Tokyo } 

{ ID = G, Region = Asia, Country = Korea, City = Seoul } 

{ ID = C, Region = Asia, Country = Pakistan, City = Karachi } 

{ ID = H, Region = Asia, Country = Turkey, City = Istanbul } 

{ ID = F, Region = Europe, Country = Russia, City = Moscow } 

{ ID = Q, Region = Europe, Country = UK, City = London } 

{ ID = K, Region = North America, Country = Mexico, City = Mexico City } 

{ ID = N, Region = North America, Country = USA, City = Los Angeles } 

{ ID = A, Region = North America, Country = USA, City = New York } 

{ ID = E, Region = South America, Country = Brazil, City = São Paulo } 

{ ID = S, Region = South America, Country = Colombia, City = Bogota } 

{ ID = T, Region = South America, Country = Peru, City = Lima } 

Program finished, press Enter/Return to continue: 

示例 说 明 

Customer 类 和 customers 列表 的 初始 化 与 前 面 例子 中 的 相同 。 因 为 要 得 看 所 有 的 顾客 ， 这 个 得 询 中 没有 
where 子 句 ， 但 按 顺 序列 出 了 要 排序 的 字段 ， 它 们 放 在 orderby fH 的 一 个 用 逗号 分 开 的 列表 中 : 


就 是 LINQ 的 工作 方式 。 如 果 知 道 select 子 句 


orderby c.Region, 


c.Country, c.city 


这 很 容易 ， 但 不 太 和 直观 ， 这 个 简单 的 字段 列表 允许 放 在 orderby 子 句 中， 但 不 能 放 在 select 子 句 中 ,不 过 


样 束 不 会 觉得 这 个 字段 列表 难以 理解 了 。 
可 给 列 出 VERF BUSAN descending 关键 字 ， 反 转 该 字段 的 排序 顺序 。 例 如 ， 要 对 得 询 结果 按 区 域 升 序 排 


会 创建 一 个 新 对 象 ， 而 根据 定义 ，orderby TAJR: iat pang E 


序 ， 再 按 国 家 降序 排序 ， 只 需要 在 列表 中 的 Country 后 面 加 上 descending 关键 字 即 可 ， 如 下 所 示 : 
orderby c.Region, c.Country descending, c.City 
添加 descending 关键 字 后 ， 结 果 如 下 : 
{ ID = J, Region = Africa, Country = Nigeria, City = Lagos } 
{ ID = O, Region = Africa, Country = Egypt, City = Cairo } 
{ ID = H, Region = Asia, Country = Turkey, City = Istanbul } 
{ ID = C, Region = Asia, Country = Pakistan, City = Karachi } 
{ ID = G, Region = Asia, Country = Korea, City = Seoul } 
{ ID = M, Region = Asia, Country = Japan, City = Tokyo } 
{ ID = P, Region = Asia, Country = Iran, City = Tehran } 
{ ID = L, Region = Asia, Country = Indonesia, City = Jakarta } 
{ ID = D, Region = Asia, Country = India, City = Delhi } 
{ ID = B, Region = Asia, Country = India, City = Mumbai } 
{ ID = R, Region = Asia, Country = China, City = Beijing } 
{ ID = I, Region = Asia, Country = China, City = Shanghai } 
{ ID = Q, Region = Europe, Country = UK, City = London } 
{ ID = F, Region = Europe, Country = Russia, City = Moscow } 
{ ID = N, Region = North America, Country = USA, City = Los Angeles } 
{ ID = A, Region = North America, Country = USA, City = New York } 
{ ID = K, Region = North America, Country = Mexico, City = Mexico City } 
{ ID = T, Region = South America, Country = Peru, City = Lima } 
{ ID = S, Region = South America, Country = Colombia, City = Bogota } 
{ ID = E, Region = South America, Country = Brazil, City = São Paulo } 


Program finished, press Enter/Return to continue: 


注意 ， 即 使 国家 的 顺序 被 反 转 了 ， 印 度 和 中 国 的 城市 仍 按 升序 排序 。 


22.11 分 组 查询 


分 组 查询 (group query) 把 数据 分 解 为 组 ， 人 允许 按 组 来 排序 、 计 算 聚 合 值 以 及 进行 比较 。 这 常 兽 是 商务 环境 
中 最 有 趣 的 查询 ( 它 驱 动 了 决策 系统 )。 例 如 ， 要 按照 国家 或 区 域 比较 销售 量 ， 确 定 在 哪里 开 新 店 或 雇用 更 多 员 
工 ， 如 下 例 所 示 。 

试 一 试 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 
(1) 在 C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 22 10_ 


分 组 查询 : BeginningCSharp7_22 10 GroupQuery\Program.cs 
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GroupQuery 。 
(2) 如 BeginningCSharp7 22 8 SelectDistinctQuery 示例 所 示 ， 创 建 Customer 类 并 初始 化 customers 列表 
(List<Customer> customers)， 这 些 代 码 与 前 面 示 例 中 的 代码 完全 相同 。 
(3) 在 Main0 方 法 的 customers 列表 初始 化 后 ， 输 入 如 下 所 示 的 两 个 得 询 : 
Var queryResults = 
from c in customers 
group c by c.Region into cg 
select new { TotalSales = cg.Sum(c => c.Sales), Region = cg.Key } 
oe orderedResults = 
from cg in queryResults 


orderby cg.TotalSales descending 
select cg 


(4) 在 Main0 方 法 中 ， 添 加 下 和 面 的 输出 语句 和 foreach 处 理 循环 : 


WriteLine ("Total\t: By\nSales\t: RegionMn----- At 一 一 一 一 一 一 "); 
foreach (var item in orderedResults) 


WriteLine ($"{item.TotalSales}\t: [item.Region]"); 
} 


(5) 结果 处 理 循环 和 Main0 方 法 中 的 其 余 代码 与 前 面 例子 中 的 相同 。 编 详 并 执行 程序 ， 下 面 是 分 组 结果 : 
Total : By 


Sales : Region 


52997 : Asia 

16999 : North America 
12444 : Europe 

8558 : South America 
7000 : Africa 


示例 说 明 

Customer 类 和 customers 列表 的 初始 化 与 前 面 例 子 中 的 相同 。 

分 组 但 询 中 的 数据 通过 一 个 键 (ke 字段 来 分 组 ， 每 个 组 中 的 所 有 成 员 都 共享 这 个 字段 值 。 在 这 个 例子 中 ， 
#2 BU Region: 


group c by c.Region 
要 计算 每 个 组 的 总 和 ， 应 生成 一 个 新 的 结果 集 cg: 
group c by c.Region into cg 


在 select 子 句 中 ， 投 影 了 一 个 新 的 匿名 类 型 ， 其 属性 是 总 销售 量 (通过 引用 cg 结果 集 来 计算 ) 和 组 的 键 值 ， 
后 者 是 用 特殊 的 组 Key 来 引用 的 : 


select new { TotalSales = cg.Sum(c => c.Sales), Region = cg.Key } 


组 的 结果 集 实 现 了 LINQ 接口 IGrouping, "E 3c FF Key 属性 。 我 们 总 以 某 种 方式 引用 Key 属性 ， 来 处 理 分 组 
结果 ， 因 为 该 属性 表示 创建 数据 中 的 每 个 组 时 使 用 的 条 件 。 

要 按 TotalSales 字段 对 结果 降序 排序 ， 以 便 碍 看 哪个 区 域 的 销售 量 最 局 、 哪 个 区 域 的 销售 量 次 局 等 ， 需 要 
创建 第 二 个 查询 ， 对 分 组 得 询 的 结果 排序 : 


var orderedResults = 
from cg in queryResults 
orderby cg.TotalSales descending 
select cg 


第 二 个 查询 是 一 个 标准 的 select 查询 , 带 一 个 orderby 子 句 , 与 前 面 示例 中 的 相同 。 但 它 没有 使 用 任何 LINQ 
分 组 功能 ， 只 是 数据 源 来 自 于 前 面 的 分 组 查询 。 
接着 输出 结果 ， 用 一 些 格式 化 代码 显示 带 有 列 标题 的 数据 ， 在 总 销售 量 与 组 名 之 间 显示 了 分 隔 符 : 
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WriteLine ("Total\t: By\nSales\t: RegionMn---Mt ---"); 
Foreach (var item in orderedResults) 
{ 
WriteLine ($"{item.TotalSales}\t: [item.Region]"); 
}e 
可 以 用 更 复杂 的 方式 进行 格式 化 ， 指 定 字段 宽度 ， 总 销售 量 右 对 齐 ， 但 这 只 是 一 个 例子 ， 不 需要 这 么 多 格 


式 ， 能 看 清 数据 ， 理 解 代码 做 了 些 什么 就 足够 了 。 
22.12 join 查询 
WIA AR PS SES ES EID) GI ST customers 和 orders 列表 等 数据 集 可 以 执行 join 得 询 , 即 可 以 用 一 个 得 


询 搜索 两 个 列表 中 相关 的 数据 ,用 键 字段 把 结果 连接 起 来 。 这 类 似 于 SQL 数据 得 询 语 言 中 的 JOIN 操作 。LINQ 
在 得 询 语法 中 提供 了 join 命令 ， 如 下 面 的 示例 所 示 。 


试 一 试 Join 查询 : BeginningCSharp7_22_11_JoinQuery\Program.cs 


按照 下 面 的 步骤 在 Visual Studio 2017 中 创建 示例 : 

(1) 在 C:\BeginningCSharp7\Chapter22 目录 中 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 22 11 
JomQuery . 

(2) 从 前 面 的 示例 中 复制 用 来 创建 Customer 尖 和 Order AVY, URILE customers 列表 (List<Customer> 
customers) 和 orders 列表 (List<Order> orders) 的 代码 。 

(3) 在 Main0 方 法 的 customers 和 orders 列表 初始 化 之 后 ， 输 入 如 下 所 示 的 租 询 : 


var queryResults = 
from c in customers 
join o in orders on c.ID equals o.ID 
select new { c.ID, c.City, SalesBefore = c.Sales, NewOrder = o.Amount, 
SalesAfter = c.Sales+o.Amount }; 


(4) 用 前 面 例子 中 使 用 的 标准 foreach 音 询 处 理 循 环 结束 程序 : 


foreach (var item in queryResults) 
i 
WriteLine (item); 


} 
(5) 编 详 并 执行 程序 ， 结 果 如 下 : 


{ ID = P, City = Tehran, SalesBefore = 7000, NewOrder = 100, SalesAfter = 7100 } 
{ ID = Q, City = London, SalesBefore = 8000, NewOrder = 200, SalesAfter = 8200 } 
{ ID = R, City = Beijing, SalesBefore = 9000, NewOrder = 300, SalesAfter = 9300 } 
{ ID = S, City = Bogota, SalesBefore = 1001, NewOrder = 400, SalesAfter = 1401 } 
{ ID = T, City = Lima, SalesBefore = 2002, NewOrder = 500, SalesAfter = 2502 } 


Program finished, press Enter/Return to continue: 


示例 说 明 

Customer 类 和 Order 类 以 及 customers 和 orders 列表 的 声明 和 初始 化 与 前 面 示 例 中 的 相同 。 

查询 使 用 join 关键 字 通 过 Customer 类 和 Order 类 的 ID 字段 ， 把 每 个 顾客 与 其 对 应 的 订单 连接 起 来 : 
var queryResults = 


from c in customers 
join o in orders on c.ID equals o.ID 


on 天 键 字 之 后 是 键 字段 (D) 的 名 称 ，equals KEFEN- Men FIFE. AWARE 
全 中 ID 字段 值 相 同 的 对 象 数据 。 

select 语句 投影 了 一 个 融 指 定 属性 的 新 数据 类 型 ， 因 此 可 以 清楚 地 看 到 最 初 的 总 销售 量 、 新 订单 和 最 终 的 
新 总 销售 量 : 


select new { c.ID, c.City, SalesBefore = c.Sales, NewOrder = o.Amount, 
SalesAfter = c.Sales+o.Amount }; 


这 个 程序 没有 在 customer X] RPR Bite, (Bn) ARAE H Ch AE FP SE X 1.55 - 
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环 的 逻辑 和 查询 中 值 的 显示 与 本 章 前 面 示例 中 的 相同 。 


- , ^n 
foreach 1/É 


22.13 “习题 


(1) 修改 第 3 个 示例 程序 BeginningCSharp7 22 3 QuerySyntax， 将 结果 降序 排列 。 

(2) 在 大 数 程序 示例 BeginningCSharp7 22 6 LargeNumberQuery 中 修改 传递 给 GenerateLotsOf Numbers() 77 
法 的 数字 ， 创 建 不 同 规模 的 结果 集 ， 看 看 得 询 结果 所 受 的 影 啊 。 

(3) 给 大 数 程序 示例 BeginningCSharp7 22 6 LargeNumberQuery 中 的 查询 添加 一 个 orderby FEJ, AAIX 
会 如 何 影 啊 性 能 。 

(4) 修改 大 数 程序 示例 BeginningCSharp7 22 6 LargeNumberQuery 中 的 查询 条 件 ， 选 择 数 字 列 表 中 的 较 
大 和 较 小 子 集 ， 看 看 这 会 如 何 影 响 性 能 ? 

(5) 修改 方法 语法 示例 BeginningCSharp7 22 4 MethodSyntax， 完 全 删除 where 子 句 ， 输 出 量 会 有 多 少 ? 

(6) 给 第 三 个 示例 程序 BeginningCSharp7 22 3 QuerySyntax 添加 聚合 运算 符 ， 哪 些 简 单 的 聚合 运算 符 适用 
于 这 种 非 数 字 的 结果 集 ? 

附录 A 给 出 了 习题 答案 。 


22.14 本章 要 点 


LINO 的 概念 和 使 用 场合 DIO 是 内 置 于 C# 中 的 一 种 查询 语言 。 使 用 LINQ 可 以 在 大 型 的 对 象 集合 、XML Rae Pe 
询 数 据 
LINQ 查询 的 组 成 部 分 LINQ 查询 包含 from. where. select 和 orderby T^] 
获取 LINQ 查询 结果 的 方式 使 用 foreach AE 4X LINQ 查询 的 结果 
延迟 执行 LINQ 查询 会 延 公 到 执行 foreach 语句 时 执行 
— 简单 的 LINQ 碍 询 使 用 查询 语法 ， 轻 高 级 的 查询 使 用 方法 得 询 。 对 于 任意 给 定 的 查询 ， 查 询 语 
— 法 和 方法 语法 的 结果 相同 
Lambda 表达 式 Lambda 表达 式 可 以 使 用 方法 语法 ， 随 时 声明 一 个 用 于 LINQ 查询 的 方法 
聚合 运算 符 使 用 LINQ 聚合 运算 符 获 得 大 型 数据 集 的 信息 ， 而 不 必 迭 代 每 个 结果 
分 组 查询 使 用 分 组 查询 给 数据 分 组 ， 再 按照 组 进行 排序 、 计 算 聚 合 值 以 及 进行 比较 
排序 使 用 orderby 运算 符 对 查询 的 结果 排序 


join 运算 符 使 用 join 运算 符 在 一 个 查询 中 查找 多 个 集合 中 的 相关 数据 


ae 


A da 库 


KEAN: 

使 用 数据 库 

理解 Entity Framework 

用 Code First 创建 数据 

在 数据 库 中 使 用 LINQ 

导航 数据 库 关 系 

在 数据 库 中 创建 和 得 询 XML 


本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp? 下 载 。 下载 代 码 位 于 Chapter23 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 
独 命名 。 


上 一 章 介绍 了 LINQ (Language INtegrated Query), REIR T LINQ 如 何 使 用 对 象 和 XML。 本章 将 学 习 如 何 将 
对 象 存 储 在 数据 库 中 ， 并 使 用 LINQ 查询 数据 。 


23.1 使 用 数据 库 


数据 库 是 永久 性 的 、 结 构 化 数据 仓库 。 有 许多 不 同 种 类 的 数据 库 ， 但 存储 和 查询 业务 数据 的 最 第 见 类 型 是 
关系 数据 库 ， 如 Microsoft SQL Server 和 Oracle。 关 系数 据 库 使 用 SQL 数据 库 语 言 (SQL 代表 结构 化 查询 语言 ， 
Structured Query Language) 来 查询 并 操纵 它们 的 数据 。 传 统 上 ， 使 用 这 样 的 数据 库 至 少 需要 知道 一 些 SQL 知识 ， 
EEE a PRA SQL 语句 , 或 在 面 同 SQL 的 数据 库 类 库 中 把 包含 SQL 语句 的 字符 串 传 递 给 API 调用 或 
方法 。 

听 起 来 很 复杂 ， 不 是 中 ?好 消息 是 ， 有 了 Visual Studio 2017， 可 以 使 用 Code First 方法 在 C# 中 创建 对 象 ， 
将 其 存储 在 数据 库 中 ， 并 使 用 LINQ 查询 对 象 ， 而 不 必 使 用 另 一 种 语言 ， 比 如 SQL. 
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23.2 ”安装 SOL Server Express 


要 运行 本 章 中 的 示例 ， 必 须 安 装 Microsoft SQL Server Express, 1%7¢ Microsoft SQL Server 的 免费 轻 量 级 版 
本 。 我 们 将 使 用 LocalDB 选项 与 SQL Server Express， 以 允许 Visual Studio 2017 直接 创建 和 打开 数据 库 文 件 ， 
而 不 必 和 连接 到 单独 的 服务 器 上 。 

"ij LocalDB 的 SQL Server Express 文 持 的 SQL 语法 与 完整 的 Microsoft SQL Server 相同 ， 所 以 它 是 适合 
于 初学 者 的 版 本 。 下 载 SQL Server Express 的 链接 如 下 : 


https:/www.microsoft.com/sql-server /sql-server-editions -express 


注意 : 
如 果 熟 悉 SQL Server， 拥 有 Microsoft SQL Server 实例 的 访问 权限 ， 就 可 以 跳 过 这 个 安装 步骤 ， 但 需要 改变 
连接 信息 ， 以 匹配 自己 的 SQL Server 实例 。 如 果 从 未 用 过 SQL Server， 就 安装 SQL Server Express。 


23.3 Entity Framework 


NET "x ff Code First 的 类 库 是 Entity Framework 的 最 新 版 本 。 这 个 名 字 来 源 于 一 个 数据 库 概 念 : 实体 天 
系 模型 。 其 中 实体 是 数据 对 象 (如 客户 ) 的 抽象 概念 ， 它 与 关系 数据 库 中 的 其 他 实体 (如 订单 和 产品 ) 相 关 ， 例 如 客 
Pil FT me 

Entity Framework 将 CHEF PRI RAR BU ARATE PEIN SEA E. AMERMAR R-RRRS. HR- 
KAR EE C# 中 的 类 、 对 象 和 属性 映射 到 构成 天 系数 据 库 的 表 、 行 和 列 的 代码 。 手 工 创建 这 个 映射 代码 非 
th sae. FEN, {E Entity Framework 使 它 很 容易 完成 。 

Entity Framework 建立 在 ADO.NET 的 基础 上 ， 而 ADO.NET 是 基于 .NET 的 低层 数据 访问 库 。 为 使 用 
ADO.NET， 需 要 掌握 一 些 SQL 知识 ， 但 幸运 的 是 ，Entity Framework 已 经 自动 处 理 了 这 个 问题 ， 用 户 可 以 专注 
于 CH 代码 。 


注意 : 

最 近 , 微软 为 NET Core 应 用 程序 引入 了 Entity Framework Core( 参 阅 第 18 章 )。 该 版 本 常 称 为 EF Core( 在 许 
多 博客 和 文章 中 ，Entity Framework 缩写 为 EF)。 本 章 中 的 示例 使 用 的 是 EF 6, 这 是 NET 4.7 可 用 的 最 新 且 最 稳 
定 的 版 本 ， 不 过 示例 中 的 模式 也 可 用 于 EF Core. 


23.4 CodeFirst 数据 库 


下 面 的 例子 使 用 Code First 和 Entity Framework 在 数据 库 中 创建 一 些 对 象 ， 然 后 使 用 LINQ to Entities 查询 
所 创建 的 对 象 。 


试 一 试 Code First 数据 库 : BeginningCSharp7 23 1 CodeFirstDatabase 


按照 以 下 步骤 在 Visual Studio 2017 中 创建 例子 : 

(1) 在 目录 C:\BeginningCSharp7\Chapter23 下 创建 一 个 新 的 控制 台 应 用 程序 项 目 BeginningCSharp7 23 1 
CodeFirstDatabase. 

(2) 单 击 OK 按钮 以 创建 项 目 。 

(3) 为 添加 Entity Framework， 按 第 21 章 的 方式 使 用 NuGet。 选 择 Tools | NuGet Package Manager | Manage 
NuGetPackages for Solution, 41/4 23-1 所 示 。 


b] BeginningCSharp?7 23 1 CodeFirstDatabase - Microsoft Visual Studio 
File Edit Project Build Debug Team 
Q-toM QM D C -| Debug 


Program.cs H X 


cs] BeginningCSharp7 23 1 CodeFirstDatabase 


View 
Get Tools and Features... 
Extensions and Updates... 
Connect to Database. 
Connect to Server... 


1 9 -jusing System; = 
using System.Collections.Gener f] 
using System.Ling; 


Code Snippets Manager... 

Choose Toolbox items... 

NuGet Package Manager 

Create GUID 

| { External Tools... 

= class Program 

{ Import and Export Settings... 

Customize... 

Options... 


using System. Text; 
using System. Threading. Tasks; 


-namespace BeginningCSharp?7_23_ 


static void Main(strir 


23-1 
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Tools | Test Analyze Window Help 


p3 1 CodeFirstDatabase.Program 
Ctri« K, Ctrl- B 
EX Package Manager Console 


PA Manage NuGet Packages for Solution... 
Č Package Manager Settings 


(4) 获得 Entity Framework 的 最 新 稳定 版 本 ， 如 图 23-2 所 示 。 单 击 Install 按钮 。 


EI Beginning Sharp? 23 1 CadeFirstDatabase - Microsoft Visual Studie 
File Edt Wew Project Build Debug 


B- Ba 


Team Jools Test 
Debug ~ Amy CPU 


Analyze Window Help 
- Pn- pe 


Browse Installed Updates Consolidate 


Entity Frarnework 


x = & [ | Include prereiease 


EntityFramework by Microsoft, 35.4M downloads 
Entity Framework is Microsoft's recommended data access technology for mew applications. 


Oracde.ManagedDataAccess.EntityFramework by Oracle, 284K downloads 
The ODP.MET, Managed Driver Entity Framework package for EF 6 applications. 


MySal.Data.Entity by Oracle, 520K downloads 
MySql. Data Entity. EFG 


4&4 23-2 


Manage Packages for Solution 


Package source: nugetorg -0 


[wi] EntityFramework 
Versinnís) - 0 
[4] | Projet 


[] BeginningCSharp? 23 1 CodeFirstDetabese 


v12.2.1100 


1 


Installed: nct installed 


Version: — Labest stable 6.2.0 


(5) 在 Preview Changes 对 话 框 中 单 击 OK 按钮 ， 如 图 23-3 所 示 。 


Preview Changes 


Visual Studio ts about to make changes to this solution. Click OK to proceed with the 


changes listed below. 


BeginningCSharp/_23_1_CodeFirstDatabase 


Installing: 
EntityFramework.6.2.0 


C] Do not show this again 
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(6) 在 如 图 23-4 所 示 的 Entity Framework 的 License Acceptance 对 话 框 中 ， 单 击 IAccept 按钮 。 


License Acceptance 


License Acceptance 


The following package(s) require that you accept their license terms before 
installing. 


EntityFramework Author(s): Microsoft 


View License 


By clicking “I Accept," you agree to the license terms for the package(s) listed 
above. If you do not agree to the license terms, click "| Decline." 


| Accept | Decline 


图 23-4 


(7) WE, Entity Framework 及 其 引用 已 添加 到 项 目 中 。 在 Solution Explorer 的 References 部 分 可 以 看 到 它 
们 ， 如 图 23-5 所 示 。 


Solution Explorer 


A- o- SGA 天 -| 


search Solution Explorer (Ctri+;) 


P BeginningCSharp7 23 1 CodeFirstDatabase 
b JE Properties 
A "B References 
& Analyzers 
OL] EntityFramework 
00 EntityFramework.SqlServer 
a Microsoft.CSharp 
"E System 
1-8 System.ComponentModel.DataAnnotations 
" System.Core 
"B System.Data 
-E System.Data.DataSetExtensions 
=E System.Net.Http 
eE System. Xml 
sE 5ystem.Xml.Ling 
4 App.config 
4.1 packages.config 


fy. Solution 'BeginningCSharp7 23 1 CodeFirstDatabase' (1 project) 


> œ Program.cs 


图 23-5 
(8) 打开 Program.cs EWE Xx fF. HAILA RAS. ACTEM TEI. Hit using 子 句 的 下 面 添加 Entity 
Framework 名 称 空间 : 
using System.Data.Entity; 
(9) 接 下 来 ， 给 数据 注解 添加 男 一 个 using 子 句 ， 以 提示 Entity Framework 如 何 建立 数据 库 。 最 后 ， 与 之 前 
的 例子 相同 ， 添 加 System.Console 名 称 空 间 : 


using System.ComponentModel.DataAnnotations; 
using static System.Console; 


(10) 接 下 来 添加 一 个 Book 类 ， 其 中 的 Author, Title 和 Code 类 似 于 第 21 章 使 用 的 例子 。Code 字段 前 的 


[Key] 特 性 是 一 个 数据 注解 ， 告 诉 C# 使 用 这 个 字段 作为 数据 库 中 每 个 对 象 的 唯一 标识 符 。 


namespace BeginningCSharp7 23 1 CodeFirstDatabase 


{ 
public class Book 
{ 
public string Title { get; set; } 
public string Author { get; set; } 
[Key] public int Code { get; set; } 
} 
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(11) 现在 添加 DbContext 类 (数据 库 上 下 文 )， 来 党 理 创 建 、 更 新 和 删除 数据 库 中 的 书籍 表 : 


public class BookContext : DbContext 
{ 

public DbSet<Book> Books { get; set; } 
} 


(12) # ROR, FE Main0 国 数 中 添加 代码 ， 创 建 两 个 Book 对 象 ， 并 保存 到 数据 库 中 : 


class Program 
{ 
Static void Main(string[] args) 
{ 
using (var db = new BookContext () ) 


Book bookl = new Book { Title = "Beginning C# 7", 
Author - "Perkins, Reid, and Hammer" ); 

db.Books.Add (book1); 

Book book2 = new Book { Title = "Beginning XML", 
Author = "Fawcett, Quin, and Ayers"); 

db.Books.Add (book2) ; 

db.SaveChanges () ; 


(13) 最 后 ， 为 一 个 简单 的 LINQ Trig sS. FU Ga US Pe RRS: 


var query = from b in db.Books 

orderby b.Title 

select b; 
WriteLine ("All books in the database:"); 
foreach (var b in query) 


{ 
WriteLine ($"{b.Title} by (b.Author), code={b.Code}"); 
} 
WriteLine ("Press a key to exit..."); 
ReadKey () ; 


程序 的 完整 代码 现在 如 下 : 


using System.Data.Entity; 

using System.Data.Annotations; 

using static System.Console; 

namespace BeginningCSharp7 23 1 CodeFirstDatabase 


{ 

public class Book 

{ 
public string Title { get; set; } 
public string Author { get; set; } 
[Key] public int Code { get; set; } 

} 

public class BookContext : DbContext 

{ 
public DbSet<Book> Books { get; set; } 

} 

class Program 

{ 


Static void Main(string[] args) 
{ 
using (var db = new BookContext ()) 
i 
Book bookl = new Book { Title = "Beginning C4 7", 
Author = "Perkins, Reid, and Hammer" }; 
db.Books.Add (book1); 
Book book2 = new Book { Title = "Beginning XML", 
Author = "Fawcett, Quin, and Ayers"); 
db.Books.Add (bookZ); 
db.SaveChanges () ; 
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var query = from b in db.Books 

orderby b.Title 

select br 
WriteLine ("All books in the database:"); 
foreach (var b in query) 


{ 
} 


WriteLine ("Press a key to exit..."); 
ReadkKey () ; 


WriteLine($"[b.Title) by {b.Author}, code={b.Code}"); 


} 


} 
(14) 编 详 并 执行 程序 (可 以 按 FS BSA). ee GS PE ES fs AR] 23-6 所 示 。 


8 ' C\BeginningCSharp/\Chapter23\BeginningCSharp/_23_1_CodeFirstDatabase\... 


图 23-6 


按 任 意 键 结束 程序 ， 关 闭 控制 台 屏 幕 。 如 果 使 用 Ctrl +F5( 启 动 但 不 调试 )， 就 可 能 需要 按 Enter/Return 键 两 
次 。 这 会 结束 程序 的 运行 。 现 在 看 看 它 是 如 何 工作 的 。 


示例 说 明 

如 前 一 半 所 示 ， 这 段 代码 使 用 了 System. Ling 名 称 空间 中 的 扩展 类 ， 创 建 项 目 时 ，Visual C£ 2017 会 日 动 插 
入 一 个 using 语句 ， 来 引用 该 名 称 空间 : 

using System.Linq; 

接 下 来 在 文件 项 部 其 他 using 子 句 的 后 面 添加 Entity Framework 名 称 空间 : 

using System.Data.Entity; 


然后 为 数据 注解 添加 using 子 句 ， 以 便 添 加 提示 ， 告 诉 Entity Framework W ESAE PHARES 
System.Console 名 称 空间 : 


using System.ComponentModel.DataAnnotations; 
using static System.Console; 


接 下 来 添加 了 一 个 Book 类 , 其 Author. Title 和 Code 类 似 于 第 21 半 中 使 用 的 例子 。 使 用 [Key] 特 性 把 Code 
属性 识别 为 数据 库 中 每 一 行 的 唯一 标识 付 。 


namespace BeginningCSharp7 23 1 CodeFirstDatabase 

{ 

public class Book 

{ 
public string Title { get; set; } 
public string Author { get; set; } 
[Rey] public int Code { get; set; } 


之 后 创建 BookContext 类 ， 它 继承 了 Entity Framework 中 的 DbContext( 数 据 库 上 下 文 ) 类 ， 用 于 在 需要 时 创 
建 、 更 新 和 删除 数据 库 中 的 book 对 象 : 


public class BookContext : DbContext 


{ 
public DbSet<Book> Books { get; set; } 
} 


类 成 员 DbSet<Book> 是 一 个 包含 数据 库 中 所 有 Book 实体 的 集合 。 
接 下 来 添加 代码 ， 以 使 用 BookContext 创建 两 个 Book 对 象 ， 并 将 其 保存 到 数据 库 中 : 


using (var db = new BookContext ()) 


{ 
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Book bookl = new Book { Title = "Beginning C# 7", 
Author = "Perkins, Reid, and Hammer" }; 

db.Books.Add (book1); 

Book book2 = new Book { Title = "Beginning XML", 
Author = "Fawcett, Quin, and Ayers"); 

db.Books.Add (book2) ; 

db.SaveChanges (); 


using(var db = new BookContext0) 子 人 句 允 许 创建 一 个 新 的 BookContext 实例 ,用 于 人 花 括号 中 的 所 有 后 续 代 码 。 
除了 方便 速记 之 外 ，using0 子 名 还 确保 结束 程序 时 ， 即 使 有 异常 或 其 他 意外 事件 ， 数 据 库 连 接 和 其 他 与 连接 相 
关 的 奔 层 对 象 会 正确 关闭 。 

Book 创建 和 赋值 语句 ， 例 如 : 


Book book = new Book { Title = "Beginning C# 7", 
Author = "Perkins, Reid, and Hammer" }; 


是 相当 简单 的 Book 对 象 创建 语句 ， 没 有 出 现 什么 数据 库 魔 法 。 因 为 这 些 都 是 内 存 中 的 简单 对 象 。 注 意 ， 
没有 给 Code 属性 赋予 任何 值 ， 上 有 目前， 未 赋值 的 Code 属性 只 包含 一 个 默认 值 。 
接 下 来 将 对 BookContext db 的 更 改 保存 到 数据 库 中 : 


db.SaveChanges (); 


现在 出 现 了 一 些 奇 怪 的 事情 ， 因 为 使 用 区 ey] 特 性 把 Code 识别 为 一 个 键 ， 把 每 个 对 象 保存 到 数据 库 中 时 ， 
将 一 个 唯一 的 值 分 配给 Code 字段 。 不 需要 使 用 这 个 值 ， 甚 到 不 需要 在 乎 它 是 什么 ， 因 为 Entity Framework 会 日 
动 处 理 它 。 


注意 : 


如 果 没 有 把 [Key] 特 性 添加 到 对 象 中 ， 程 序 运 行 时 ， 


class Program 


{ 


就 会 显示 一 个 如 图 23-7 所 示 的 异常 。 


static void Main(string[ ] arg 


using (var db = new BookCi 


ABI 


|. ation.ModelValidationException: 
Book bookl = new Book: 


Exception Unhandled n X 
System.Data.Entity.ModelConfigur +; 


'One or more validation errors were m | 


| View Details Copy Details 
Title = "Beginnin 


Author z "Perkins; 


P Exception Settings 


h m Ae 
Hb.Books.Add(booki); 加 
Book book2 = new Book 


最 后 ， 


var query = from b in db.Books 
orderby b.Title 
select br 


WriteLine ("All books in the database:"); 


foreach (var b in query) 


给 一 个 简单 的 LINQ 查询 执 行 代 码 ， 列 出 创建 后 数据 库 中 的 书籍 : 


WriteLine($"{b.Title} by {b.Author}, code={b.Code}"); 


} 

WriteLine ("Press a key to exit..."); 
ReadKey () ; 

} 


这 个 LINQ 查询 非常 类 似 于 前 一 章 使 用 的 查询 ， 但 它 不 使 用 LINQ to Objects 提供 程序 查询 内 存 中 的 对 象 
而 是 用 LINQ to Entities 提供 程序 查询 数据 库 。LINQ 根据 查询 中 引用 的 类 型 推断 正确 的 提供 程序 ， 不 需要 对 多 


FEITE MZE. 


最 后 在 退出 前 ， 只 使 用 标准 的 ReadKeyO， 来 暂停 程序 ， 以 便 可 以 看 到 输出 。 
这 很 容易 ， 对 吧 ? 创建 一 些 对 象 ， 傈 存 到 数据 库 中 ， 使 用 LINQ filii NE o 
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23.5 ”数据 库 的 位 置 


创建 的 数据 库 位 于 哪个 位 置 ? 我 们 永远 不 会 指定 文件 名 或 文件 夹 位 置 一 一 好 奇怪 ! 在 Visual Studio 2017 中 
通过 Server Explorer 可 以 看 到 它 。 进 入 Tools | Connect to Database. Entity Framework 将 创建 一 个 数据 库 ， 放 在 


它 在 计算 机 上 找到 的 第 一 个 本 地 SQL Server 实例 中 。 


如 果 计 算 机 里 以 前 从 来 没有 任何 数据 库 ，Visual Studio 2017 就 会 自动 创建 一 个 本 地 SQL Server 实例 
(localdb)NMSSQLLocalDB 。 要 连接 到 该 数据 库 ， 在 Server name 字段 中 输入 (localdb)NMSSQLLocalDB， 如 图 23-8 


所 示 。 
注意 : 


如 果 使 用 Visual C£ 2017 前 安装 了 Visual Studio 的 一 个 旧版 本 ， 就 可 能 需要 在 Server name 字段 中 输入 
(localdb)vv11.0， 因 为 这 是 前 一 版 的 本 地 数据 库 名 。 如 果 安 装 了 SQL Server Express Edition， 就 可 能 需要 输 


Add Connection ? 


Enter information to connect to the selected data source or click "Change" to choose a different 
data source and/or provider. 


Data source: 
Microsoft SQL Server (SglClient) 


Server name: 


(localdb)\MSSQOLLocalDB 
Log on to the server 


Authentication: | Windows Authentication 


Save my password 


Connect to a database 


(@) Select or enter a database name: 


BeginningCSharp? 23 1. CodeFirstDatabase.BookContext 


Č) Attach a database file: 


Advanced... 


Test Connection Cancel 


图 23-8 


入 \sqlexpress， 因 为 Entity Framework 会 使 用 它 找到 的 第 一 个 本 地 SQL Server 数据 库 。 


假设 在 例子 中 输入 的 名 字 与 本 章 所 示 完 全 相同 ， 则 包含 数据 的 数据 库 称 为 BeginningCSharp7_23_1_ 
CodeFirstDatabase.BookContext。 龙 点 时 间 连 接 后 ， 它 会 出 现在 Select or enter a database name 字段 中 。 
现在 可 以 按 下 OK 键 ， 数 据 库 将 出 现在 Visual Studio 2017 的 Server Explorer 中 的 Data Connections 窗口 中 ， 


如 图 23-9 所 示 。 
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Server Explorer 


> > Azure 
4 g? Data Connections 


现在 就 可 以 直接 探索 数据 库 。 例 如 ， 可 以 右 击 Books 表 ， 并 选择 Show Table Data, AAA CMAN AGE. 
如 图 23-10 所 示 。 


4 上 hp-desktop\sql .BeginningCSharp/ 23 1 CodeFirstDatabase.BookContext.db 
e EN RU PA ORE ENE WES PSDR DUNES Ifi : 3 Beginnin gXML Fawcett, Quin, and Ayers 
4 E Tables 一 
NULL NULL 
Add New Table 
Add New Trigger 
New Query 
Open Table Definition 


23.6 “导航 数据 库 关 系 


Entity Framework 最 强大 的 一 个 方面 是 它 能 自动 创建 LINQ 对 象 ， 帮 助 找 到 数据 库 中 相关 的 表 之 间 的 关系 。 
下 例 将 添加 两 个 与 Book 类 相关 的 新 类 ， 生 成 一 个 简单 的 书店 库存 报告 。 狐 类 称 为 Store( 代 表 每 个 书店 ) 和 
Stock( 代 表 在 商店 货架 上 的 书 和 从 出 版 商 那 里 订购 的 书 )。 这 些 新 类 和 关系 的 图 如 图 23-11 所 示 。 


Store 
€? Storeld 
Name 
Address 
Inventory 
€ Stockld 
OnHand 
OnOrder 


图 23-11 


每 个 商店 都 有 名 称 、 地 址 和 库存 集合 (由 一 个 或 多 个 Stock 对 象 组 成 ， 每 个 Stock 对 象 对 应 书店 中 每 本 不 同 
的 书 ( 书 名 )，Store 和 Stock 之 间 是 一 对 多 关系 。 每 个 Stock 记录 正好 与 一 本 书 有 关 ，Stock 和 Book 之 间 是 一 对 
一 关系 。 需 要 库存 记录 ， 因 为 一 个 商店 可 能 有 三 本 相同 的 书 ， 但 另 一 个 商店 可 能 有 六 本 相同 的 书 。 

^H f Code First， 就 只 需要 创建 C# 对 象 和 集合 ， 而 Entity Framework 会 目 动 创建 数据 库 结 构 ， 以 便 你 轻松 
地 导航 数据 库 对 象 之 间 的 关系 ， 然 后 在 数据 库 中 查询 相关 对 和 象 。 
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试 一 试 ”导航 数据 库 关系 : BeginningCSharp7_23 2_DatabaseRelations 


按照 以 下 步骤 在 Visual Studio 2017 中 创建 例子 : 

(1) 在 目录 C:\BeginningCSharp7\Chapter23 下 创建 一 个 新 的 控制 台 应 用 程序 项 目 BeginningCSharp7 23 2 
DatabaseRelations. 

(2) 单 击 OK 按钮 以 创建 项 目 。 

(3) 使 用 NuGet 添加 Entity Framework， 与 前 面 的 例子 一 样 。 选 择 Tools[INuGet Package Manager|Manage 
NuGetPackages for Solution. 

(4) 在 NuGet Package Manager 中 ， 选 择 Entity Framework, Eri] Include Prerelease 复 选 枉 ， 获 得 Entity 
Framework 最 新 的 稳定 版 本 。 单 击 Install 按钮 。 它 不 需要 下 载 , 因为 前 一 步 已 经 下 载 了 它 。 单 击 Preview Changes 
上 的 OK Fl, Hih License Acceptance 对 话 框 中 的 LAccept 按钮 。 

(5) 打开 Program.cs 主 源 文件 .与 前 面 的 示例 一 样 ,给 System.Console、 System.Data.Entity 和 DataAnnotations 
AB IBI using 语句 ， 以 及 创建 Book 类 的 代码 : 

using System.Data.Entity; 

using System.ComponentModel.DataAnnotations; 


using static System.Console; 
namespace BeginningCSharp7 23 2 DatabaseRelations 


{ 

public class Book 

{ 
public string Title { get; set; } 
public string Author { get; set; } 
[Key] 
public int Code { get; set; } 

} 


(6) 现在 声明 Store 和 Stock 类 ， 如 下 所 示 。 确 保 将 Inventory 和 Item 声明 为 virtual. Ja e HHA. 


Public class Store 


{ 
[Key] 
public int StoreId { get; set; } 
public string Name { get; set; } 
public string Address { get; set; } 
public virtual List<Stock> Inventory { get; set; } 
} 
public class Stock 
{ 
[Key] 
public int StockId { get; set; } 
public int OnHand { get; set; } 
public int onOrder { get; set; } 
public virtual Book Item{ get; set; ) 
} 


(7) #4428 DbContext 类 添加 Stores 和 Stocks: 


public class BookContext : DbContext 


{ 
public DbSet<Book> Books { get; set; } 
public DbSet<Store> Stores { get; set; } 
public DbSet<Stock> Stocks { get; set; } 
} 


(8) 现在 将 代码 添加 到 Main0 方 法 中 ， 以 使 用 BookContext， 创 建 Book 类 的 两 个 实例 ， 与 前 面 的 例子 一 样 : 


class Program 
{ 
static void Main(string[] args) 
{ 
using (var db = new BookContext ()) 
{ 
Book bookl = new Book 
{ 
Title = "Beginning C# 7", 
Author = "Perkins, Reid, and Hammer" 
he 
db.Books.Add (book1) ; 
Book book2 - new Book 


Title = "Beginning XML", 
Author = "Fawcett, Quin, and Ayers" 
J; 
db.Books.Add (book2) ; 
} 


#238 数据 Æ | 509 


(9) 现在 ， 在 using(var db = newBookContext0) 子 句 中 给 第 一 个 书店 添加 实例 及 其 库存 : 


var storel = new Store 


{ 
Name = "Main St Books", 
Address = "123 Main St", 
Inventory = new List<Stock>() 
}s 


db.Stores.Add(storel); 

Stock storelbookl - new Stock 

{ Item = bookl, OnHand = 4, OnOrder = 6 }; 
storel.Inventory.Add(storelbookl); 
Stock storelbook2 - new Stock 

{ Item = book2, OnHand = 1, OnOrder 
storel.Inventory.Add(storelbook2); 


(10) 给 第 二 个 书店 添加 实例 及 其 库存 : 


var store2 = new Store 

{ 
Name = "Campus Books", 
Address = "323 College Ave", 
Inventory = new List«Stock»() 


I 
w 
- 


}; 

db.Stores.Add(store2); 

Stock store2bookl - new Stock 

{ Item = bookl, OnHand = 7, OnOrder 
store2.Inventory.Add(store2book1l); 
Stock store2book2 - new Stock 

{ Item = book2, OnHand = 2, OnOrder = 8 }; 
store2.Inventory.Add(store2book2); 


(11) 接着 保存 数据 库 的 修改 ， 与 前 面 的 例子 相同 : 
db.SaveChanges () ; 
(12) 现在 在 所 有 的 书店 上 创建 一 个 LINQ 查询 ， 并 输出 结果 : 


Var query = from store in db.Stores 
orderby store .Name 
select store; 


(13) 最 后 添加 代码 ， 输 出 查询 的 结果 ， 并 暂停 ; 


WriteLine ("Bookstore Inventory Report:"); 
foreach (var store in query) 


23 }; 


{ 
WriteLine ($"{store.Name} located at (store.Address)"); 
foreach (Stock stock in store.Inventory) 
{ 
WriteLine($"- Title: {stock.Item.Title}"); 
WriteLine($"-- Copies in Store: {stock.OnHand}"); 
WriteLine($"-- Copies on Order: {stock.OnOrder}"); 
) 
) 


WriteLine("Press a key to exit..."); 
ReadKey () ; 


} 
(14) 编译 并 执行 程序 (可 以 按 F5 键 ， 局 动 调试 )。 书 店 库 存 的 信息 如 图 23-12 所 示 。 
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E" C\GeginningCsharp/\Chapter2s\BeginningCSharp/_23_2 DatabaseRelations\BeginningCsharp/_23_2 DatabaseRelations... 


- m ym 此- TET 3 jr NP 


图 23-12 


按 任意 键 结束 程 序 ， 关 闭 控制 台 屏 幕 。 如 果 使 用 Ctrl + FS( 局 动 但 不 调试 )， 就 可 能 需要 按 Enter/Retum 键 两 
次 。 结 束 程序 的 运行 。 现 在 分 析 它 是 如 何 工作 的 。 


示例 说 明 
Entity Framework 的 基础 DbContext 和 数据 注解 在 前 面 的 例子 中 讲 过 了 。 所 以 这 里 只 关注 不 同 之 处 。 
Store 和 Stock 类 和 原来 的 Book 类 是 相似 的 ， 但 给 Inventory 和 Item 添加 了 一 些 新 的 virtual 属性 ， 如 下 


所 示 : 

Public class Store 

{ 
[Key] 
public int StoreId { get; set; } 
public string Name { get; set; } 
public string Address { get; set; } 
public virtual List<Stock> Inventory { get; set; } 


public class Stock 


{ 
[Key] 
public int StockId { get; set; } 
public int OnHand { get; set; } 
public int OnOrder { get; set; } 
public virtual Book Item{ get; set; } 
} 


Inventory 属性 的 外 观 和 行为 像 一 个 普通 的 内 存 中 List<Stock> 集 合 。 然 而， 因为 它 声 明 为 virtual， 所 以 在 数 
据 库 中 存储 和 检索 它 时 ，Entity Framework 可 以 重 写 其 行为 。 

Entity Framework 负责 数据 库 的 详细 信息 ， 比 如 给 数据 库 中 的 Stocks 表 添加 一 个 外 键 列 ， 实 现 Store 和 Stock 
记录 之 间 的 Inventory 关系 。 同 样 ，Entity Framework 将 男 一 个 外 键 列 添加 到 数据 库 的 Stock 表 中 ， 实 现 Stock 和 
Book 之 间 的 Item 关系 。 在 BeginningCSharp7 23 2 DatabaseRelations.BookContext 数据 库 的 Server Explorer 数 


据 库 设 计 视 图 中 可 以 看 到 它们 ， 如 图 23-13 Ara. 
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dbo.Stocks [Design] - X 
$ Update Script File: dbo.Stocks.sql 


Name Data Type Allow Nulls Default 4 Keys (1) 
PK dbo.Stocks (Primary Key, Clustered: Stockld) 
Check Constraints (0) 
4 Indexes (2) 
IX Item Code (Item Code) 
IX Store Storeld (Store Storeld) 
4 Foreign Keys (2) 
FK dbo.Stocks dbo.Books ltem Code (Code) 
FK dbo.5tocks dbo.5tores Store Storeld (Storeld) 
Triggers (0) 


=ë Stockld 
OnHand 
OnOrder 
Item Code 


5tore Storeld 


OK KOO O 


Q Design « th ~ ST-SOL 
CREATE TABLE [dbo]. [Stocks] 
[StockId] INT IDENTITY (1, 1) NOT NULL, 
[OnHand] INT NOT NULL, 
[Onorder] INT NOT NULL, 
[Item Code] INT NULL, 
[Store Storeld] INT NULL, 
CONSTRAINT [PK dbo.Stocks] PRIMARY KEY CLUSTERED ([StockId] ASC), 
CONSTRAINT [FK dbo.Stocks dbo.Books Item Code] FOREIGN KEY ([Item Code]) REFERENCES [dbo].[Books] ([Code]), 
CONSTRAINT [FK dbo.Stocks dbo.Stores Store StoreId] FOREIGN KEY ([Store StoreId]) REFERENCES [dbo].[Stores] ([StoreId] 


图 23-13 


过 去 ， 必 须 决定 如 何 将 程序 中 的 集合 映射 到 数据 库 中 的 外 键 和 列 上 ， 并 在 设计 发 生变 化 时 ， 使 这 些 代码 保 
持 最 新 。 然而 , 有 了 Entity Framework， 束 不 需要 知道 这 些 细 节 。 有 了 Code First， 只 需要 处 理 CHAISE, Entity 
Framework 会 目 动 完成 其 他 工作 。 

接 下 来 在 BookContext 中 添加 Store 和 Stock 的 DbSet 类 。 


public class BookContext : DbContext 


j 


w cO) *J om un 4» w hJ 


{ 
public DbSet<Book> Books { get; set; } 
public DbSet<Store> Stores { get; set; } 
public DbSet<Stock> Stocks { get; set; } 
} 


然后 用 这 些 DbSet 类 来 创建 两 本 书 、 两 家 商店 和 两 个 库存 记录 (每 个 商店 中 的 每 本 书 ) 的 实例 : 


class Program 
{ 


Static void Main(string[] args) 


{ 
using (var db = new Bookcontext () ) 
{ 
Book bookl = new Book 
{ 
Title = "Beginning C# 7", 
Author = "Perkins, Reid, and Hammer" 
bi 


db.Books.Add(book1); 
Book book? = new Book 
{ 
Title = "Beginning XML", 
Author = "Fawcett, Quin, and Ayers" 
he 
db.Books.Add (book?) ; 
var storel = new Store 


{ 
Name = "Main St Books", 
Address = "123 Main St", 
Inventory = new List<Stock> () 
b 


db.Stores.Add(storel); 

Stock storelbookl - new Stock 

{ Item = bookl, OnHand = 4, OnOrder = 6 }; 
storel.Inventory.Add(storelbookl); 

Stock storelbook2 - new Stock 

{ Item = book2, OnHand = 1, OnOrder = 9 }; 
storel.Inventory.Add(storelbook2); 
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var store2 = new Store 
( 
Name — "Campus Books", 
Address — "323 College Ave", 
Inventory = new List<Stock>() 
); 
db.Stores.Add(store2); 
Stock store2bookl - new Stock 
{ Item = bookl, OnHand = 7, OnOrder = 23 }; 
store2.lInventory.Add(store2bookl); 
Stock store2book2 - new Stock 
{ Item = book2, OnHand = 2, OnOrder = 8 Jj; 
store2.Inventory.Add(store2book2); 


创建 对 象 后 ， 就 把 更 改 保存 到 数据 库 中 : 
db.SaveChanges () ; 


然后 建立 一 个 简单 的 LINQ 查询 ， 列 出 所 有 商店 的 信息 : 
Var query = from store in db.Stores 
orderby store .Name 
select store; 


打印 查询 结果 的 代码 非 营 简单 ， 因 为 它 只 处 理 对 象 和 集合 ， 没 有 数据 库 的 特定 代码 : 


WriteLine ("Bookstore Inventory Report:"); 
foreach (var store in query) 


{ 
WriteLine($"[store.Name)] located at {store.Address}"); 
foreach (Stock stock in store.Inventory) 
{ 
WriteLine ($"- Title: [stock.Item.Title)"); 
WriteLine($"-- Copies in Store: {stock.OnHand}"); 
WriteLine ($"-- Copies on Order: {stock.OnOrder}"); 
} 
} 


为 了 打印 每 个 商店 的 库存 ， 上 只 需要 使 用 一 个 foreach 循环 ， 与 处 理 任何 集合 一 样 。 


23.7 ”处 理 迁移 


开发 代码 时 ， 难 免 有 改变 想法 的 时 候 。 属 性 可 能 有 更 好 的 名 称 ， 或 者 友 现 需要 一 个 新 的 类 或 关系 。 如 果 通 
过 Entity Framework 改变 关中 连接 到 数据 库 的 代码 ， 第 一 次 运行 改变 了 的 程序 时 ， 就 会 遇 到 如 图 23-14 所 示 的 
Invalid Operation Exception. 


class Program 
| — . "M . | Exception Unhandled 
static void Main(string[] arg; 
1 | | System.InvalidOperationException: ‘The model backing the 
using (var db = new BookC! 'BookContext' context has changed since the database was created. 


| Consider using Code First Migrations to update the database (http:// 
Book bookl = new Book; go.mucrosoft.com/fwlink/?Linkldz 238263). 
| View Details Copy Details 
Title - "Beginnin 


Authors = "Perkin| P Exception Settings 


h | 
db.Books.Add(bock1); 


图 23-14 


使 数据 库 与 发 生 更 改 的 类 保持 一 致 是 很 复杂 的 ， 但 有 了 Entity Framework， 步 又 会 相对 容易 。 正 如 错误 消 
恩 所 建议 的 ， 需 要 同 程序 添加 Code First Migrations €. 

为 此 ， 进 入 Tools | NuGet Package Manager | Package Manager Console。 这 将 打开 一 个 命令 窗口 ， 如 网 23-15 
所 示 。 

要 把 数据 库 自动 迁移 到 更 新 的 类 结构 中 ， 应 在 Package Manager Console 的 PM> 提 示 下 输入 如 下 命令 : 


Enable-Migrations -EnableAutomaticMigrations 
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Package Manager Console 


Package source: All - @ Default project: BeginningCSharp? 23 1 CodeFirstDatabase 
Type 'get-help NuGet' to see all available NuGet commands. 


PM» Enable-Migrations -EnableAutomaticMigrations 

Checking if the context targets an existing database... 

Code First Migrations enabled for project BeginningCSharp7 23 1 CodeFirstDatabase. — 

PM» Update-Database -Force 

Specify the '-Verbose' flag to view the SQL statements being applied to the target database. 
No pending explicit migrations. 

Applying automatic migration: 201711021042489 AutomaticMilgration. 

Running Seed method. 

PM» 

100% = 


Package Manager Console Error List Output 


Solution Explorer 
G 865 - -Sap ^ 
Search Solution Explorer (Ctri+:) 
"1 Solution 'BeginningCSharp? 23 1 CodeFirstDatabase" (1 
á BeginningCSharp7_23_1_CodeFirstDatabase 
b & Properties 
b =m References 
4 (MN Migrations 
> 3 Configuration.cs 
4$ App.config 
4) packages.config 
b c Program.cs 


23-16 


Entity Framework 会 比较 数据 库 和 程序 的 时 间 蕉 ， 当 数据 库 与 类 不 同步 时 ， 建 议 同步 。 要 更 新 数据 库 ， 只 
ifr Package Manager Console 的 PM> 提 示 下 输入 如 下 命令 : 


Update-Database -Force 


23.8 在 已 有 的 数据 库 中 创建 和 查询 XML 


最 后 一 个 例子 将 结合 前 面 所 学 的 LINQ、 数 据 库 和 XML. 

XML 通常 用 于 客户 机 和 服务 器 之 间 的 数据 通信 ,或 多 层 应 用 程序 的 “ 层 ” 之 间 的 数据 通信 。 我 们 常 要 在 数 
据 库 中 查询 一 些 数据 ， 然 后 从 该 数据 中 生成 一 个 XML 文档 或 片段 ， 传 递 到 另 一 层 。 

下 面 的 示例 将 创建 一 个 查询 ， 在 前 面 的 示例 数据 库 中 查找 一 些 数据 ， 使 用 LINQ to Entities 查询 数据 ， 然 后 
使 用 LINQ to XML 类 把 数据 转换 为 XML。 这 是 一 个 Database First 示例 ， 而 不 是 Code First 编程 例子 ， 它 利用 现 
有 的 数据 库 ， 并 从 中 生成 C# 对 象 。 


试 一 试 ” 从 数据 库 中 生成 XML: BeginningCSharp7 23 3 XMLfromDatabase 


按照 以 下 步骤 在 Visual Studio 2017 中 创建 例子 : 

(1) 在 目录 C:\BeginningCSharp7\Chapter23 下 创建 一 个 新 的 控制 台 应 用 程序 BeginningCSharp7 23 3_ 
XMLfromDatabase. 

(2) 如 前 面 的 示例 所 述 ， 把 Entity Framework 添加 到 项 目 中 。 

(3) 给 前 面 示例 中 使 用 的 数据 库 添 加 连接 ， 方 法 是 选择 Project | Add New Item, Æ Add New Item 对 话 框 中 
选择 ADO.NET Entity Data Model， 把 名 称 从 Modell 改 为 BookContext， 如 图 23-17 所 示 。 
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Add New Item - BeginningCSharp7 23 3 AMLfromDatabase 


4 Installed 


4 Visual C= Items 
Code 
Data 


Windows Forms 


WPF 
SQL Server 


b Online 


(5) 在 Entity Data Model Wizard 中 ， 选 择 前 和 面 示例 创建 的 BeginningCSharp7 23 2 DatabaseRelations. 


EF Designer 
from 
database 


Sort by: 


af 


Empty EF 
Designer 
model 


Default 

Class 

Interface 

Windows Form 

User Control 

Component Class 

User Control (WPF) 

About Box 

ADO.NET Entity Data Model 
Application Configuration File 
Application Manifest File 
Assembly Information File 
Bitmap File 

Code Analysis Rule Set 


Code File 


23-17 


Visual C£ Items 


Visual C* Items 


Visual C£ Items 


Visual C£ Items 


Visual C# Items 


Visual C¥ Items 


Visual CË Items 


Visual C* Items 


Visual C* Items 


Visual C£ Items 


Visual CË Items 


Visual C£ Items 


Visual C£ tems 


Visual C£ Items 


ali. 


Search (Ctrl--E) 


Type: Visual C* items 


A project item for creating an ADO.NET 


Entity Data Model. 


Add 


选择 Code First from database, "Jl 23-18 所 示 。 


First model 


for the model, and database objects to include in the model. 


Pe 
图 


BookContext 数据 库 的 连接 ， 如 图 23-19 所 示 。 


23-18 


Finish 


| Creates a Code First model based on an existing database. You can choose the database connection, settings 


| Cancel 


| Cancel 


Entity Data Model Wizard 


| 
w Choose Your Data Connection 


Which data connection should your application use to connect to the database? 
hp-desktop\sqglexpress.BeginningC Sharp? 23 2 DatabaseRelations.BookCon ~ New Connection.. 


Connection string: 


| data sourcez Asglexpress;initial 
catalogz BeginningCSharp? 23 2 DatabaseRelations.BookContext;integrated 


security- True; MultipleActrveResultSets- True App- EntityFramework 


Save connection settings in App.Config as: 


BookContext 


Cancel 
图 23-19 


(6) 打开 Program.cs 主 源 文件 。 
(7) 在 Program.cs 的 开头 添加 对 System.Xml.Linq 名 称 空 间 的 一 个 引用 ， 如 下 所 示 : 


using System; 

using System.Collections.Generic; 
using System. Linq; 

using System. Xml .Linq; 

using System.Text; 

using static System.Console; 


(8) 在 Program.cs 中 给 Main0 方 法 添加 如 下 代码 : 


static void Main(string[] args) 
{ 
using (var db = new BookContext()) 
{ 
var query = from store in db.Stores 
orderby store.Name 
select store; 
foreach (var s in query) 
{ 
XElement storeElement = new XElement("store", 
new XAttribute("name", s.Name), 
new XAttribute("address", s.Address), 
from stock in s.Stocks 
select new XElement("stock", 
new XAttribute("StockID", stock.StockId), 
new XAttribute("onHand", 
stock.onHand), 
new XAttribute ("onOrder", 
stock.OnOrder) , 
new XElement("book", 
new XAttribute("title", 
stock.Book.Title), 
new XAttribute("author", 
stock.Book.Author) 
)// end book 
) // end stock 
); // end store 
WriteLine (storeElement) ; 
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} 
Write ("Program finished, press Enter/Return to continue:"); 
ReadLine (); 
} 
} 


(9) 编译 并 执行 程序 (可 以 按 F5 键 ， 启 动 调试 )。 输 出 如 图 23-20 所 示 。 


8 * CABeginningCSharpAChapter23ABeginningCSharp7 23 3 XMLfromDatabase\BeginningCs... 


F sis um mam 
F 


ey 


图 23-20 


按 Enter/Retum 键 退出 程序 ， 关 闭 控 制 台 屏幕 。 如 果 使 用 Chl+F5 键 (启动 但 不 调试 )， 就 可 能 需要 按 Enter/Retum 


键 两 次 。 


示例 说 明 

在 Program.cs 中 添加 了 对 System.Xml.Linq 名 称 空间 的 引用 ， 以 调用 LINQ to XML 构造 图 数 类 和 Entity 
Framework 28. 

在 Add New Item 对 话 框 中 选择 ADO.NET Entity Data Model, XIN Database First 代码 时 ， Visual Studio 会 
使 用 前 面 例子 创建 的 现 有 数据 库 BeginningCSharp7 23 2 DatabaseRelations.BookContext 的 信息 ， 生 成 一 个 单独 
的 BookContext.cs 类 ， 并 添加 到 项 目 中 。 

在 主 程序 中 ， 创 建 了 BooksContext 数据 库 上 下 文 类 的 实例 和 与 前 面 例子 中 相同 的 LINQ to Entities AW: 


using (var db = new BookContext ()) 

1 

var query = from store in db.Stores 
orderby store.Name 
select store; 


在 foreach 循环 里 处 理 查询 的 结果 时 ， 使 用 LINQ to XML 2$. LINQ to XML 的 一 组 嵌 套 元 素 和 特性 ， 把 查 
询 结果 转换 成 XML。 


foreach (var 5 in query) 
{ 
XElement storeElement = new XElement("store", 
new XAttribute("name", s.Name), 
new XAttribute("address", s.Address), 
from stock in s.Stocks 
select new XElement("stock", 
new XAttribute("StockID", stock.StockId), 
new XALttribute("onHand", 
stock.OnHand), 
new XAttribute ("onOrder", 
stock.OnOrder), 
new XElement ("book", 
new XAttribute("title", 
stock.Book.Title), 
new XAttribute("author", 


* 23x Zi dE Æ | 517 


stock.Book.Author) 
)// end book 
) // end stock 
); // end store 
WriteLine(storeElement); 


} 
XX LAE Hi LINQ 和 Entity Framework 的 全 部 功能 ， 把 第 22 ÆA 23 章 的 数据 访问 知识 结合 到 一 个 程序 中 。 


23.9 ”习题 


(1) 修改 第 一 个 示例 BeginningCSharp7 23 1 CodeFirstDatabase， 提 示 用 户 输入 书 名 和 作者 ， 把 用 户 输入 的 
数据 存储 到 数据 库 中 。 

(2) 如 果 反 复 运 行 ， 第 一 个 例子 BeginningCSharp7_23_1_CodeFirstDatabase 会 创建 重复 的 记录 。 修 改 例子 ， 
使 其 不 创建 重复 的 记录 。 

(3) 最 后 一 个 例子 BeginningCSharp7 23 3 XMLfromDatabase 生成 的 BookContext 类 所 使 用 的 关系 名 称 不 
同 于 前 面 的 示例 BeginningCSharp7 23 2 DatabaseRelations。 修 改 BookContext 类 ， 以 使 用 相同 的 关系 名 。 

(4) 使 用 Code First 创建 一 个 数据 库 ， 存 储 第 21 章 的 GhostStories.xml 文件 中 的 数据 。 

附录 A 给 出 了 习题 答案 。 


23.10 ABBA 


to m8 要 A 
使 用 数据 库 数据 库 是 永久 的 、 结 构 化 的 数据 仓库 。 有 许多 不 同类 型 的 数据 库 ， 业 务 数据 最 利用 的 类 型 是 关系 数据 库 


Entity Framework Entity Framework 是 一 组 NET 类 ， 表 示 C# 对 象 和 关系 数据 库 之 间 的 对 象 -关系 映射 

如 何 使 用 Code First 在 Entity Framework 中 使 用 Code First， 可 使 用 对 象 -关系 映射 ， 直 接 从 C# 类 和 集合 中 创建 数据 库 
创建 数据 

如 何在 数据 库 中 使 用 | LINQ to Entities 可 使 用 与 创建 数据 相同 的 Entity Framework 类 ， 文 持 在 数据 库 上 运行 强大 的 得 询 功能 
LINQ 

如 何 导航 数据 库 关 系 | Entity Framework 允许 在 数据 库 中 通过 使 用 C# 人 代码 中 的 虚拟 属性 和 集合， 创建 和 导航 相关 实体 

如 何在 数据 库 中 创建 | 可 在 单个 查询 中 组 合 使 用 LINQ to Entities、LINQ to Objects 和 LINQ to XML， 在 数据 库 中 构建 XML 
和 查询 
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Windows Communication Foundation 


REAR: 

e WCF 的 含义 

e 掌握 WCF 概念 
e 理解 WCF 编程 


本 章 源 代码 可 以 通过 本 书 合作 站 点 wroxcom 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 下 载 。 下 载 代码 位 于 Chapter24 文件 夹 中 并 已 根据 本 章 示例 的 名 称 单 
ut. 


近年 来 ， 随 看 Internet 的 日 益 普 及 ，Web 服务 得 以 迅速 发 展 。Web HS 30 — | Web 站 点 ， 只 不 过 是 由 计 
算 机 (而 不 是 人 ) 使 用 的 。 例 如 ， 除 了 浏览 菜 个 Web 站 点 来 得 看 自己 豆 欢 的 电视 节目 的 信息 外 ， 还 可 以 使 用 一 个 
果 面 应 用 程序 ， 通 过 某 个 Web 服务 提取 相同 的 信息 。 这 种 方法 的 优势 是 ， 同 一 个 Web 服务 可 被 各 种 应 用 程序 
使 用 ， 其 中 也 包括 Web 站 点 。 而 且 ， 可 以 编写 目 己 的 应 用 程序 或 Web 站 点 来 使 用 第 三 方 的 Web 服务 。 例 如 ， 
把 目 己 哥 欢 的 电视 节目 的 信息 与 地 图 服务 结合 起 来 ， 以 显示 该 节目 的 拍摄 现场 。 

NET Framework x fi Web 服务 已 经 有 一 段 时 间 了。 但 在 最 近 的 版 本 中 ， 它 把 Web 服务 与 远程 技术 结合 起 
来 ， 创 建 出 Windows Communication Foundation(WCF)， 这 是 在 应 用 程序 之 间 进 行 通 信 的 一 种 通用 基础 结构 。 

远程 技术 可 在 一 个 进程 中 创建 对 象 实例 ， 在 另 一 个 进程 中 使 用 它们 ， 即 使 创建 对 象 的 计算 机 与 使 用 对 象 的 
计算 机 不 同 也 同样 如 此 。 但 这 种 技术 仍 有 它 自 己 的 问题 。 远 程 技术 是 有 限制 的 ， 而 且 刚 入 门 的 程序 员 要 掌握 它 
也 不 容易 。 

WCE 从 Web 服务 中 提取 了 服务 、 独 立 于 平台 的 SOAP 消息 传输 等 概念 ， 把 它们 与 远程 技术 中 的 宿主 服务 
句 应 用 程序 和 高 级 绑 定 功能 结合 在 一 起 ， 所 以 可 将 这 种 技术 看 成 一 个 超 集 ， 包 含 了 Web 服务 和 远程 技术 ， 但 比 
Web 服务 强大 ， 比 远程 技术 更 易于 掌握 。 使 用 WCF， 可 从 简单 的 应 用 程序 转向 使 用 SOA(Service-Oriented 
Architecture， 面 问 服 务 的 架构 ) 的 应 用 程序 。SOA 意味 看 可 分 散 处 理 ， 并 在 需要 时 连接 跨 本 地 网 络 和 Internet 的 
服务 和 数据 ， 使 用 分 布 式 处 理 。 

本 草 将 学 习 如 何在 应 用 程序 代码 中 创建 和 使 用 WCE 服务 。 另 外 ， 本 章 也 介绍 了 WCF 的 原理 ， 这 些 知识 同 
样 重要 ， 可 以 帮助 理解 其 工作 机 制 。 
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24.1 WCF 的 含义 


WCE 技术 人 允许 创建 服务 ， 可 以 路 进程 、 计 算 机 和 网 络 从 其 他 应 用 程序 访问 这 些 服务 。 利 用 这 些 服务 ， 可 在 
多 个 应 用 程序 中 共 盏 功能 ， 提 供 数据 源 ， 或 者 抽象 复杂 进程 。 

WCF 服务 提供 的 功能 也 封 竣 为 该 服务 的 方法 ， 由 该 服务 提供 。 每 个 方法 一 在 WCF 术语 中 称 为 “操作 
(operatiom) ”一 一 每 个 操作 都 有 一 个 痛 点 ， 用 于 交换 数据 。 根 据 用 于 连接 服务 的 网 络 和 特定 的 要 求 ， 这 种 数据 交 
换 可 能 由 一 个 或 更 多 个 协议 定义 。 

在 WCF 中 ， 病 点 可 以 有 多 个 绑 定 ， 每 个 绑 定 都 指定 一 种 通信 方式 。 绑 定 还 可 指定 其 他 信息 ， 例 如 ， 必 须 
满足 什么 安全 要 求 才 能 与 疹 点 通信 。 例 如 ， 绑 定 可 能 需要 用 户 名 和 密码 身份 验证 或 者 Windows H1? WE P 48 
在 连接 一 个 疹 点 时 ， 绑 定 使 用 的 协议 会 影响 所 使 用 的 地 址 ， 如 后 面 所 述 。 

一 旦 连接 了 一 个 疹 点 ， 就 可 以 使 用 SOAP 或 REST(Representational State Transfer) 消 恩 与 它 通 信 。 所 使 用 的 
消 息 形式 取决 于 所 进行 的 操作 和 该 操作 收发 消 明 所 需 的 数据 结构 。 WCEF 使 用 协定 (contracb 指 定 所 有 这 些 信 息 。 通 
过 与 服务 交换 的 元 数据 可 以 查找 协定 。 用 于 找 出 服务 信息 的 一 种 币 用 格式 是 Web Service Description 
Lanpguage(WSDIL)， 它 最 初 用 于 Web Wks. Ax, WCF 服务 还 可 用 其 他 方式 来 摘 述 。 


注意 : 
WCE 的 使 用 和 设置 方式 变化 多 端 。 可 以 使 用 WCF 来 创建 REST(Representative State Transfer) 服 务 。 这 些 服 务 
依赖 简单 HTTP 请 求 在 客户 端 和 服务 器 之 间 通 信 ， 因 此 ， 与 SOAP 消息 相 比 ， 它 们 更 小 。 


识别 出 要 使 用 的 服务 和 痛 点 ， 知 道 了 要 使 用 的 绑 定 和 需要 依从 的 协定 后 ， 束 可 与 WCF 服务 通信 ， 这 与 使 
用 在 本 地 定义 的 对 象 一 样 简单 。 与 WCF 服务 通信 可 以 是 简单 的 单 回 事务 、 请 求 / 啊 应 消息 ， 也 可 以 是 从 通信 信 
道 任 一 咒 发 出 的 全 双 工 通信 ， 还 可 以 在 需要 时 使 用 消 县 负载 优化 技术 ， 如 Message Transmission Optimization 
Mechanism(MTOMD) 来 打包 数据 。 

WCE 服务 在 存储 它 的 计算 机 上 运行 为 许多 不 同 进程 中 的 一 个 。Web 服务 总 是 运行 在 IS 上 ， 而 WCF 服务 
可 以 选择 适合 的 宿主 进程 。 可 以 使 用 nS 驻 留 WCF 服务 ， 也 可 以 使 用 Windows 服务 或 可 执行 程序 。 如 果 使 用 
TCP 在 本 地 网 络 上 与 WCF 服务 通信 ， 束 不 需要 在 运行 服务 的 PC ERR IS. 

WCE 框架 允 许 定制 本 节 介 绍 的 几乎 所 有 方面 ,但 这 是 一 个 高 级 主题 , 本 间 仅 使 用 .NET 4.7 默认 提供 的 技术 。 

TAE WCF 服务 的 基础 知识 后 ， 下 面 将 详细 介绍 这 些 概念 。 


24.2 WCF 概念 


本 节 描 述 WCE 的 如 下 方面 : 


e WCF 通信 协议 

e i. Jue E 
e 协定 

e 消息 模式 

。 行为 

e 驻 留 


24.2.1 WCF 通信 协议 


如 前 所 述 ， 可 以 通过 许多 传输 协议 与 WCF 服务 通信 。 在 .NET 4.7 Framework 中 定义 了 5 个 协议 : 

e HTTP: 它 允 许 与 任何 地 方 ( 包 括 跨 Internet) WCF 服务 通信 。 可 以 使 用 HTTP 通信 技术 创建 WCF Web 
服务 。 

e TCP: 如 果 正 确 配置 了 防火 墙 ， 它 允许 与 本 地 网 络 或 跟 Internet H] WCF 服务 通信 。TCP tt HTTP rg X 
功能 也 比较 多 ， 但 配置 起 来 更 复杂 。 
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e UDP: 类 似 于 TCP， 也 人 允许 通过 本 地 网 络 或 Internet 进行 通信 ， 但 它 的 实现 方式 与 TCP 略 有 不 同 。 这 
种 实现 允许 服务 同时 问 多 个 客户 端 广 播 消 明 。 

e 命名 管道 : CRIS WCF 服务 通信 ， 该 WCF 服务 与 调用 代码 位 于 同一 台 计算 机 的 不 同 进程 上 。 

e MSMQ: 这 是 一 种 排队 技术 ， 人 允许 应 用 程序 发 送 的 消息 通过 队列 路 由 到 目的 地 。MSMQ 是 一 种 可 靠 的 
消息 传输 技术 ， 可 以 确保 发 送 给 队列 的 消息 一 定 达到 该 队列 。MSMQ 还 是 一 种 异步 技术 ， 所 以 只 有 排 
在 前 面 的 消息 都 处 理 完 毕 ， 服 务 仍 有 效 时 ， 才 能 处 理 当 前 消息 。 

这 些 协 议和 常常 允许 建立 安全 连接 。 例 如 ， 可 以 使 用 HTTPS 协议 建立 Internet 上 的 TLS 连接 。TCP 使 用 

Windows 安全 架构 为 本 地 网 络 上 的 安全 性 能 提供 了 更 多 可 能 性 。UDP 则 不 支持 安全 性 。 
为 连接 WCF 服务 ， 必 须知 道 它 在 什么 地 方 。 这 表示 必须 知道 端点 的 地 址 。 


242.2 地址 、 端 点 和 绑 定 


用 于 服务 的 地 址 类 型 取决 于 所 使 用 的 协议 。 本 章 前 面 介绍 的 3 个 协议 (不 包括 MSMQ) 部 需要 格式 化 的 服务 
地 址 : 

e HTTP: HTTP 协议 的 地 址 是 URL， 其 格式 很 常见 ，http://<server>:<port>/<service>。 对 于 TLS 连接 ， 
也 可 以 使 用 https://<server>:<port>/<service>。 如 果 在 IS 中 驻 留 服务 ，<service> 就 是 扩展 名 为 .sve HJ X. 
fF. TIS 地 址 可 能 包含 比 这 个 示例 更 多 的 子 目 录 ， 即 .sve 文件 之 前 有 更 多 使 用 /字符 分 隔 的 部 分 。 

e TCP: TCP 的 地 址 采用 net.tep://<server>:<port>/<service> 形 式 。 

e UDP: UDP 的 地 址 采用 soap.udp://<server>:<port>/<service>。 对 于 多 播 通 信 ， 和 需要 为 <server> 使 用 一 些 
特定 值 ， 但 这 超出 了 本 章 的 讨论 范围 。 

e 命名 管道 : 命名 省 道 连接 的 地 址 与 上 述 类 似 ， 但 没有 新 口号 。 其 形式 是 net.pipe://<server>/ «service». 

服务 的 地 址 是 一 个 基地 址 ， 它 可 用 于 为 表示 操作 的 疡 点 创建 地 址 。 例 如 ， 在 net.tep://<server>: 

<port>/<service>/operation! 上 有 一 个 探 作 。 

例如 ， 假 定 创建 一 个 WCF 服务 ， 它 有 一 个 操作 ， 绑 定 了 表面 介 绍 的 3 个 协议 ， 就 可 以 使 用 下 面 的 基地 址 : 

http: //www.mydomain.com/services/amazingservices/mygreatservice.svc 

net .tcp://myhugeserver: 8080/mygreatservice 

net .pipe://localhost/mygreatservice 

接 者 就 可 以 给 操作 使 用 下 面 的 地 址 ; 

http: //www.mydomain.com/services/amazingservices/mygreatservice.svc/greatop 


net.tcp://myhugeserver:8080/mygreatservice/greatop 
net.pipe://localhost/mygreatservice/greatop 


从 NET4 开 始 ， 可 给 操作 使 用 默认 端点 ， 而 不 必 明 确 地 配置 它们 。 这 简化 了 配置 ， 如 果 需 要 使 用 标准 端点 
地 址 (如 上 例 所 示 )， 这 表现 得 尤其 明显 。 

如 前 所 述 ， 绑 定 不 仅 指 定 了 操作 使 用 的 传输 协议 ， 还 可 以 指定 在 传输 协议 上 通信 的 安全 要 求 、 端 上 的 事务 
处 理 功 能 和 消 姑 编码 等 。 

绑 定 提供 了 极 大 灵活 性 ， 所 以 .NET Framework 提供 了 一 些 可 用 的 预定 义 绑 定 。 还 可 将 这 些 绑 定 用 作 起 
点 ， 修 改 它 们 ， 得 到 需要 的 绑 定 类 型 。 预 定义 绑 定 有 一 些 必须 遭 循 的 原则 。 每 种 绑 定 类 型 都 用 
System.ServiceModel 名 称 空间 中 的 一 个 类 表示 。 表 24-1 列 出 了 最 第 用 的 绑 定 及 其 基本 信息 。 


表 24-1 HERP 
绑 定 说 明 
BasicHttpBinding 最 简单 的 HITP HE, Web 服务 使 用 的 默认 绑 定 ， 它 的 安全 功能 有 限 ， 不 文 持 事务 处 理 
WSHttpBinding HTTP 绑 定 的 一 种 较 高 级 形式 ， 可 以 使 用 WSE 中 引入 的 所 有 额外 功能 


扩展 了 WSHttpBinding 功 能 ， 包 含 双 同 通信 功能 。 在 双 辣 通信 中 ， 服 务 器 可 以 启动 与 客户 端的 


WSDualHttpBindine 
Pg 通信 ， 还 可 以 进行 一 般 的 消息 交换 
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( 续 表 ) 
0 E 说 明 
WSFederationHttp 扩展 了 WsSHttpBinding 功能 ， 包 含 联 合 功 能 。 联 合 功 能 允许 第 三 方 实现 单 点 登录 (single sign-on) 
Binding 和 其 他 专用 安全 措施 。 这 是 一 个 高 级 主题 ， 本 章 不 予 讨论 
NetTcpBinding 用 于 TCP 通信 ， 人 允许 配置 安全 性 、 事 务 处 理 等 
NetNamedPipeBinding 用 于 命名 管道 的 通信 ， 人 多 许配 置 安全 性 、 事 务 处 理 等 
NetMsmqBinding 这 些 绑 定 用 于 MSMQ， 本 章 不 予 讨论 
NetPeerTcpBinding 用 于 对 等 绑 定 ， 本 章 不 予 讨论 
WebHttpBinding 用 于 使 用 HTTP 请 求 (而 不 是 SOAP 消息 ) 的 Web 服务 
UdpBinding 允许 绑 定 到 UDP 协议 


这 个 表 中 的 许多 绑 定 类 拥有 可 用 于 其 他 配置 的 类 似 属 性 。 例 如 ， 它 们 有 可 用 于 配置 超时 值 的 属性 。 本 草 后 
面 介 绍 编码 时 会 详细 讨论 。 
端点 的 默认 绑 定 因 所 用 协议 而 异 。 这 些 默认 绑 定 如 表 24-2 所 示 。 


表 24-2 NET RURE 
mh N mA A 58 XE 
BasicHttpBinding 
NetTcpBinding 
UdpBinding 


道 NetNamedPipeBinding 


24.2.3 协定 
协定 确定 了 WCF 服务 的 用 法 。 可 以 定义 如 下 几 种 协定 : 


服务 协定 : 包含 服务 的 一 般 信息 和 服务 提供 的 操作 的 一 般 信息 。 例 如 ， 该 协定 可 以 包含 服务 使 用 的 名 
PREH. Æ SOAP 消息 定义 模式 时 ， 服 务 使 用 唯一 的 名 称 空间 ， 以 免 与 其 他 服务 冲突 。 

操作 协定 : 定义 操作 的 用 法 ， 这 包括 操作 方法 的 参数 和 返回 类 型 ， 以 及 其 他 信息 ， 例 如 ， 方 法 是 否 返 
回响 应 消息 。 

消息 协定 : 允许 定制 SOAP 消息 内 部 的 信息 格式 化 方式 。 例 如 ， 数据 应 包含 在 SOAP 标 头 中 还 是 SOAP 
消息 体 中。 在 创建 必须 与 昌 系 统 集成 的 WCF 服务 时 ， 就 可 以 使 用 消息 协定 。 

错误 协定 : 定义 操作 可 能 返回 的 错误 。 使 用 NET 客户 问 程 序 时 ， 错 误会 导致 可 以 捕获 的 异 利 ， 并 以 通 
常 方式 处 理 。 

数据 协定 : 如 果 使 用 复杂 类 型 ， 如 用 户 定 义 的 结构 和 对 象 (作为 操作 的 参数 或 返回 类 型 )， 就 必须 为 这 些 
关 型 定义 数据 协定 。 数 据 协 定 根据 通过 属性 显示 的 数据 来 定义 类 型 。 


一 般 使 用 特性 把 协定 添加 到 服务 类 和 方法 中 ， 如 本 章 后 面 所 述 。 


24.24 


消息 模式 


上 一 节 提 到 ， 操 作协 定 可 以 定义 操作 是 否 返 回 一 个 值 ，WSDualHttpBinding 允许 进行 双 同 通信 。 这 些 都 是 
HRN. HERAA 3 TOUS. 


请 求 / 啊 应 消息 传输 : 交换 消息 的 “一 般 ” 方式， 每 个 有 友 送 给 服务 的 消息 都 会 生成 一 个 及 送 给 客户 端的 
啊 应 。 这 并 不 意味 痢 客 户 问 必须 要 等 竺 啊 应 ， 因 为 可 用 一 般 方 式 异 步调 用 操作 。 
单 问 消息 传输 : WAM RP m Hed WCE 操作 ， 但 服务 器 不 友 送 啊 应 。 
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e 双 回 消息 传输 : “MRR, BP ima AEH ar, Horus tnn] DATE m. Jaa, X 
In] 115 ean JG VT c RUD Ar BE OAS, EAS HT peA PRIN e 
AS 3 Js TS Hd 1 EY ES 


2425 行为 


11 A(behavior) t ERA Behe Rare P? Ya E] A BIA RS BRET STARS SAT, BY LAPS 
制 答 主 进程 如 何 实 例 化 和 使 用 行为 ， 行 为 如 何 参 与 事务 处 理 ， 在 服务 中 如 何 解 决 多 线程 问题 等 。 操 作 行 为 可 以 
控制 在 操作 执行 过 程 中 是 含 使 用 模仿 功能 ， 各 个 操作 行为 如 何 影 啊 事务 处 理 等 。 

可 在 不 同 的 级 别 上 指定 风 认 行为 ， 而 不 必 给 每 个 服务 和 操作 指定 每 个 行为 的 各 个 方面 。 还 可 在 需要 时 提供 
URBAN SUE. W Pr ia Ac ee 


242.6 JER 


本 章 开头 曾 提 到 ，WCEF 服务 可 以 存储 在 几 个 不 同 进程 中 ， 包 括 : 

e Web 服务 器 : 驻 留 在 IS 的 WCF 服务 是 WCEF 提供 的 最 接近 Web 服务 的 服务 。 还 可 以 使 用 WCF 服务 
中 的 高 级 功能 和 安全 特性 ， 这 些 功能 和 特性 很 难 在 Web 服务 中 实现 ， 也 可 以 集成 IS 特性 ， 如 ns 安全 
特性 。 

e 可 执行 文件 :可 以 把 WCF 服务 驻 留 在 .NET 中 创建 的 任意 应 用 程序 类 型 中 , 如 控制 台 应 用 程序 .Windows 

窗 体 应 用 程序 和 WPF 应 用 程序 。 
e Windows 服务 : 可 以 把 WCF 服务 驻 留 在 Windows 服务 中 ， 这 意味 大 可 以 使 用 Windows 服务 提供 的 有 
用 特性 ， 包 括 目 动 启动 和 错误 恢复 。 

e Windows Activation Service(WAS): 专门 用 于 驻 留 WCF 服务 ， 基 本 上 是 ns 的 一 个 简化 版 本 ， 可 以 在 

任何 没有 us 的 地 方 使 用 。 

上 述 列表 中 的 两 个 选项 IIS 和 WAS 73 WCF 服务 提供 了 有 用 的 特性 ， 例 如 激活 、 进 程 回收 和 对 象 池 。 如 果 
使 用 另外 两 个 驻 留 选项 ，WCF 服务 就 是 日 驻 留 的 。 我 们 偶尔 会 目 驻 留 服务 ， 以 进行 测试 ， 但 最 好 创建 日 驻 留 、 
产品 级 的 服务 。 例 如 ， 假 定 不 允许 在 运行 服务 的 电脑 上 安装 Web 服务 器 。 如 果 服 务 运行 在 域 控 制 器 上 ,或 者 公 
司 的 本 地 策略 只 是 禁止 运行 IS， 就 可 以 把 服务 驻 留 在 Windows 服务 上 ， 它 会 工作 得 很 好 。 


24.3 WCF 编程 


前 面 介 绍 了 基础 知识 ， 下 面 开 始 编写 一 些 代 码 。 本 节 首 先 介绍 一 个 在 Web 服务 器 上 驻 留 的 简单 WCF 服务 
和 一 个 控制 台 客 户 端 程序 。 介 绍 了 所 创建 的 代码 结构 后 ， 学 习 WCF 服务 和 客户 端 应 用 程序 的 苛 本 结构 。 此 后 
详细 探讨 一 些 重要 主题 : 

e 定义 WCF 服务 协定 

e 自 驻 留 的 WCF 服务 


试 一 试 ” 一 个 简单 的 WCF 服务 和 客户 端 程 序 : Ch24Ex01Client 


(1) f£ C:\BeginningCSharp7\Chapter24 目录 中 创建 一 个 新 的 WCF 服务 应 用 程序 项 目 Ch24Ex01 . 

(2) 在 解决 方案 中 添加 一 个 控制 台 应 用 程序 Ch24Ex01Client。 

(3) f£ Build 沫 羊 上 单 击 Build Solution 选项 。 

(4) 在 Ch24Ex01Client WHF, Æ Solution Explorer 中 右 击 References， 选 择 Add Service Reference 选项 。 

(5) 在 Add Service Reference 对 话 框 中 ， 单 击 Discover. 

(6) 局 动 开 发 Web 服务 器 ， 加 载 WCF 服务 的 信息 后 ， 展 开 该 引用 ， 香 看 其 细节 ， 注 意 服 务 中 有 两 个 方法 ; 
GetData 和 GetDataUsingDataContract. 
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(7) 单 击 OK 按钮 ， 添 加 服务 引用 。 
(8) 在 Ch24Ex01Client 应 用 程序 中 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 


using Ch24Ex01Client.ServiceReferencel; 
using static System.Console; 


namespace Ch24Ex01Client 


class Program 
{ 
static void Main(string[] args) 
{ 
Title = "Ch22Ex01Client"; 
int intParam; 
do 
i 
WriteLine("Enter an integer and press enter to call the WCF service."); 
} while (!int.TryParse (ReadLine(), out intParam) ); 
ServicelClient client = new ServicelClient(i); 
WriteLine(client.GetData(intParam)); 
WriteLine("Press an key to exit."); 
ReadkKey () ; 


} 
} 
} 


(9) 在 Solution Explorer 中 右 击 Ch24Ex01Client 项 目 ， 选 择 Set as StartUp Project 选项 。 
(10) 运行 应 用 程序 。 在 控制 台 应 用 程序 窗口 中 输入 一 个 数字 ， 按 下 回 车 键 ， 结 果 如 图 24-1 所 示 。 


8' Ch24Ex01Client 


图 24-1 


(11) 退出 应 用 程序 ， 在 Solution Explorer 中 右 击 Ch24Ex01 项 目 中 的 Servicel.sve X fF, "iti View in 
Browser. 

(12) 查看 窗口 中 的 信息 。 

(13) 单 击 Web 页 和 面 顶部 的 链接 ,查看 服务 的 WSDL。 现在 还 不 需要 了 解 WSDL 文件 中 的 所 有 内 容 的 含义 。 


示例 说 明 

这 个 示例 中 创建 了 一 个 驻 留 在 Web 服务 器 上 的 简单 Web 服务 和 控制 台 客 户 端 程序 。 ETA WCF 服务 项 目 
使 用 了 默认 的 Visual Studio 模板 ， 这 意味 着 不 必 目 己 添加 任何 代码 ， 而 是 可 以 使 用 这 个 默认 模板 中 定义 的 一 个 
操作 GetData0。 对 于 这 个 示例 ， 使 用 什么 操作 并 不 重要 ， 而 应 关注 代码 的 结构 及 其 工作 方式 。 

首先 分 析 服 务 器 项 目 Ch24Ex01, ERA: 

e 文件 Servicel.svce， 它 定义 了 服务 的 答 主 。 
类 定义 CompositeType， 它 定义 了 服务 使 用 的 数据 协定 (位 于 IServicel.cs 代码 文件 中 )。 
接口 定义 IServicel， 它 定义 了 服务 协定 和 两 个 操作 协定 。 
类 定义 Servicel， 它 实现 IServicel 接口 ， 定 义 了 服务 的 功能 (位 于 Servicel.sve.cs 代码 文件 中 )。 
配置 段 <system.serviceModel>( 在 Web.config 中 )， 它 配置 了 服务 。 

Servicel.sve 文件 包含 如 下 代码 行 。 要 查看 这 行 代码 ， 应 在 Solution Explorer 中 右 击 该 文件 ， 再 单 击 View 
Markup: 


<$@ ServiceHost Language="C#" Debug-"true" Service-"Ch24Ex01.Servicel" 
CodeBehind-"Servicel.svc.cs" %> 


这 是 一 个 ServiceHost 指令 ， 用 于 告诉 Web 服务 器 (本 例 是 Web 开发 服务 器 ， 但 该 指令 也 可 应 用 于 ITS) 把 什 
么 服务 存储 在 这 个 地 址 上 。 定 义 服务 的 类 在 Service 特性 中 声明 ， 定 义 这 个 类 的 代码 文件 在 CodeBehind 特性 中 
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声明 。 这 个 指令 是 必需 的 ， 以 获得 Web 服务 器 的 驻 留 功能 ， 如 前 面 几 节 所 述 。 
显然 ， 没 有 驻 留 在 Web 服务 右上 的 WCF 服务 不 需要 这 个 文件 。 本 和 章 后 面 将 学 习 目 驻 留 的 WCF 服务 。 
PEE IServicel.es 文件 中 定义 数据 协定 CompositeType。 从 代码 中 可 以 看 出 ， 数 据 协 定 只 是 一 个 类 定义 ， 
类 定义 中 包含 了 DataContract 特性 ， 类 成 员 上 包含 了 DataMember 特性 ，; 


[DataContract ] 
public class CompositeType 
{ 
bool boolValue = true; 
string stringValue = "Hello "; 
[DataMember] 
public bool BoolValue 
i 
get { return boolValue; | 
set { boolValue = value; ] 
} 
[DataMember |] 
public string StringValue 
i 
get { return stringValue; } 
set { stringValue = value; } 
} 
} 


XX 4 CIS DE I TUUS Be Dar e) HU. FHEEFE (Eas BP WSDL 文件 ， 就 会 看 到 这 些 元 数据 )。 这 人 允 
许 客户 端 应 用 程序 定义 一 个 类 型 ,该 类 型 可 以 序列 化 到 窗 体 上 , 该 窗 体 又 可 以 由 服务 反 序列 化 到 CompositeType 
对 象 上 。 客 户 端 程序 不 需要 知道 这 个 类 型 的 实际 定义 ， 实 际 上， 客户 端 程序 使 用 的 类 可 以 有 不 同 的 实现 代码 。 
定义 数据 协定 的 这 种 方式 虽 人 简单 但 非常 强大 ， 人 允许 在 WCF 服务 及 其 客户 端 程序 之 间 交 换 复杂 的 数据 结构 。 
IServicel.cs 文件 还 包含 服务 协定 ， 该 服务 协定 定义 为 各 有 ServiceContract 特性 的 接口 。 这 个 接口 也 在 服务 
元 数据 中 进行 了 完整 摘 述 ， 并 可 在 客户 端 应 用 程序 中 重建 。 接 口 成 员 构成 了 服务 的 操作 ， 每 个 操作 都 应 用 
OperationContract 特性 创建 一 个 操作 协定 。 示 例 代 码 包含 两 个 操作 ， 其 中 一 个 操作 使 用 了 前 面 的 数据 协定 : 
[Servicecontract] 


public interface IServicel 
{ 
[OperationContract] 
string GetData(int value); 
[OperationContract] 
CompositeType GetDataUsingDataContract (CompositeType composite); 


] 
前 面 介绍 的 4 个 协定 定义 特性 都 可 以 用 特性 进一步 配置 ， 如 下 一 节 所 述 。 实 现 服务 的 代码 与 其 他 类 定义 
Ki: 


public class Servicel : IServicel 
public string GetData(int value) 
return string.Format("You entered: {0}", value); 


} 
public CompositeType GetDataUsingDataContract (CompositeType composite) 
i 


} 
} 


注意 这 个 类 定义 不 需要 继承 目 特 定 类 型 ， 也 不 需要 任何 特定 的 特性 ， 只 需要 实现 定义 了 服务 协定 的 接口 。 
实际 上 ， 可 以 在 这 个 类 及 其 成 员 中 添加 特性 ， 以 指定 行为 ,但 这 些 都 不 是 强制 的 。 

把 服务 的 实现 代码 (类 ) 和 服务 协定 (接口 ) 分 开 的 效果 极 佳 。 客 户 端 程序 不 需要 了 解 类 的 任何 信息 ， 类 包含 的 
功能 可 能 远 远 超过 了 服务 实现 的 功能 。 一 个 类 甚至 可 以 实现 多 个 服务 协定 。 

最 后 分 析 Web.config 文件 中 的 配置 。 在 配置 文件 中 ，WCF 服务 的 配置 是 从 .NET 远程 技术 中 提取 出 来 的 
一 个 特性 , 可 以 处 理 所 有 类 型 的 WCF 服务 ( 非 和 目 驻 留 的 服务 和 目 驻 留 的 服务 ) 和 WCF 服务 的 客户 端 程序 ( 稍 后 
介绍 )。 

WCF 配 置 代码 包含 在 Web.config 或 app.config 文 件 的 配置 段 <system.serviceModel> 中 。 这 个 示例 使 用 了 默认 
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值 ， 所 以 没有 进行 很 多 服务 配置 。 在 Web.config 文 件 中 ， 配 置 段 包含 一 个 子 段 ， 它 为 服务 行为 <behaviors> 苗 写 
了 默认 值 。Web.config 中 的 <system_.serviceModel> 配 置 段 的 代码 如 下 (为 简洁 起 见 ， 删 除了 注释 ): 
«system.serviceModel-» 
«behaviors» 
<serviceBehaviors> 
<behavior> 
<serviceMetadata httpGetEnabled="true" httpsGetEnabled="true" /> 
«serviceDebug includeExceptionDetailInFaults-"false" /> 
</behavior> 
</serviceBehaviors> 
«/behaviors» 
</ system. serviceModel> 


这 个 配置 段 可 在 <behavior> 子 段 中 定义 一 个 或 多 个 行为 ， 这 些 行为 可 在 多 个 其 他 元 素 上 重用 。 可 给 
<behavior> 段 指定 一 个 名 称 ， 以 便 进 行 重 用 (这 样 束 可 以 在 其 他 地 方 引 用 它 )， 也 可 以 不 指定 名 称 来 使 用 (如 本 例 
所 示 )， 以 指定 重 与 默认 的 行为 设置 。 


注意 : 

如 果 使 用 了 非 默 认 的 配置 ， 在 <system serviceModel> 中 就 会 包 仿 一 个 <services> 段 ， 其 中 包含 一 个 或 多 个 
«service»-T- Ft, «service» PCT VA €, 2-endpoint»-f- AK, 每 个 <endpoint> 子 段 都 定义 了 服务 的 一 个 端点 。 实际 上 ， 
所 定义 的 端点 是 服务 的 基 端 点 。 可 从 中 推断 出 操作 的 端点 。 


在 Web.config 中 ， 重 写 的 一 个 默认 行为 如 下 : 
«serviceDebug includeExceptionDetailInFaults-"false"/» 
这 个 设置 可 以 是 tue， 在 传输 给 客户 端 程序 的 任意 错误 中 提供 异常 详情 ， 通 常 只 允许 在 开发 过 程 中 传输 这 
EC E ta ehe 
在 Web.config F, 73 — ERA TITI 531173 8 UG HA TOBE TG VE ERI PERI RAS WCF 服务 的 描述 。 
BRU BCE AIRS EX SPATE Ei. — I FP EAP IRR AE: 23 — PY PRS AR HY 762 
Hio TE Web.config 文件 中 ， 可 禁用 这 个 功能 ， 如 下 所 示 : 


<serviceMetadata httpGetEnabled="false" 
httpsGetEnabled="false" /> 


另外 ， 还 可 完全 删除 这 行 配置 代码 ， 因 为 默认 行为 不 允许 交换 元 数据 。 

如 宁 在 本 例 中 答 试 茶 用 这 个 功能 ， 并 不 能 阻止 客户 冰 程 序 访问 服务 ， 因 为 客户 闪 程 序 已 经 在 添加 服务 引用 
时 获得 了 需要 的 元 数据 。 但 禁用 元 数据 会 禁止 其 他 客户 问 程 序 使 用 Add Service Reference 工具 访问 这 个 服务 。 一 
般 情 况 下 ， 生 产 环境 中 的 Web 服务 不 需要 提供 元 数据 ， 所 以 应 在 开 友 阶段 完成 后 禁用 这 个 功能 。 

前 面 介绍 了 WCF 服务 的 代码 , 现在 分 析 客 户 端 程序 ， 尤 其 是 使 用 Add Service Reference 工具 做 了 什么 。 注 
意 在 Solution Explorer 中 ， 客 户 问 程序 包含 一 个 文件 夹 Service References， 如 果 展 开 该 文件 来， 就 会 看 到 一 个 
ServiceReferencel Jil, EE YSIS) HIN H MAER 

Add Service Reference 工具 创建 了 访问 服务 需要 的 所 有 类 。 这 包括 服务 的 代理 类 , 服务 的 代理 类 包含 服务 的 
所 有 操作 方法 (ServicelClient)， 以 及 从 数据 协定 中 生成 的 客 尸 喘 类 (CompositeType)。 


注意 : 
可 以 浏览 Add Service Reference 工具 生成 的 代码 (显示 项 目 中 的 所 有 文件 ， 包 括 隐 藏 的 文件 )。 


该 工具 还 为 项 目 添 加 了 一 个 配置 文件 app.config， 这 个 配置 定义 了 两 个 内 容 : 
e HRI im BBE fai 4s. 

e 端点 的 地 址 和 协定 

从 服务 描述 中 提取 绑 定 信息 : 

<configuration> 


«system.serviceModel- 
«bindings 
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<basicHttpBinding> 
<binding name-"BasicHttpBinding IServicel" /> 
</basicHttpBinding> 
</bindings> 
IX SABIE. ARF WYSE HAE GK Ee WebHk 2S 38-66 fii ARS H. sve SC PHBE) Al DE 2 P? 9m CAS IServicel Em £x 
配置 中 使 用 : 
<client> 
<endpoint address-"http://localhost:49227/Servicel.svc" 
binding-"basicHttpBinding" 
bindingConfiguration-"BasicHttpBinding IServicel" 
contract-"ServiceReferencel.IServicel" 
name-"BasicHttpBinding IServicel" /» 
«/client» 
</system.serviceModel> 
</configuration> 


如 果 删 除 <bindings> 段 和 <endpoint> 元 素 的 bindingConfiguration 特性 ， 客 户 端 程序 将 使 用 默认 的 绑 定 配置 。 
<binding> 元 素 的 名 称 是 BasicHttpBinding IService1， 这 里 包含 它 是 为 了 定制 绑 定 的 配置 。 这 里 可 用 的 配置 
有 和 很多， 包括 超时 设置 、 消 息 大 小 限制 和 安全 设置 等 。 如 果 服 务 项 目 把 这 些 配置 指定 为 非 默认 值 ， 就 可 以 在 
app.config 文件 中 看 到 它们 ， 因 为 它们 会 被 复制 到 这 个 文件 中 。 只 有 绑 定 配置 匹配 时 ， 客 户 闪 程序 才能 与 服务 通 
信 。 本 章 不 深入 探讨 WCF 服务 配置 。 
这 个 示例 介绍 了 许多 基础 知识 ， 下 面 总 结 一 下 前 和 面 的 内 容 : 
e WCF 定义 
口 服务 由 服务 协定 接口 定义 ， 其 中 包括 操作 协定 成 员 
口 服务 在 实现 了 服务 协定 接口 的 类 中 实现 
口 数据 协定 只 是 使 用 数据 协定 特性 的 类 型 定义 
e WCF 服务 配置 
口 可 使 用 配置 文件 (Web.config 或 app.config KALE. WCF 服务 
e WCF Web 服务 器 驻 留 : 
口 Web 服务 器 驻 留 把 .sve 文件 用 作 服 务 基地 址 
e WCE 客户 程序 配置 : 
口 可 使 用 配置 文件 (web.config 或 app.config) 来 配置 WCF 服务 的 客户 器 程序 
下 一 节 将 详细 介绍 协定 。 


24.3.1 WCF 测试 客户 端 程序 


上 面 的 示例 创建 了 服务 和 客户 端 程序 , 说 明了 基本 WCE 体系 结构 的 工作 原理 ， 以 及 如 何 归 档 WCF 服务 的 
配置 。 但 实际 要 使 用 的 客户 中 应 用 程序 会 比较 复杂 ， 也 难以 正确 测试 服务 。 

为 便于 开发 WCF WKS, Visual Studio 提供 了 一 个 测试 工具 ， 可 用 于 确保 WCF 操作 正常 工作 。 这 个 工具 会 
自动 配置 为 处 理 WCF 服务 项 目 ， 所 以 如 果 运 行 项 目 ， 该 工具 就 会 显示 出 来 。 只 需要 确保 要 测试 的 服务 ( 即 .sve 
文件 ) 设 置 为 WCF 服务 项 目的 局 动 页 面 即 可 。 

可 使 用 该 工具 调用 服务 操作 ， 还 可 以 用 其 他 方式 检查 服务 。 如 下 面 的 示例 所 示 。 


试 一 试 ” 使 用 WCF Min 3st: Ch24Ex01\Web.config 


(1) 打开 上 一 个 示例 中 的 WCF Service Application 项 目 Ch24Ex01 . 
(2) 在 Solution Explorer 中 右 击 Servicel.sve 服务 ， 然 后 单 击 Set As Start Page. 
(3) 在 Solution Explorer 中 右 击 Ch24Ex01 项 目 ， 然 后 单 击 Set As StartUp Project. 
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<serviceMetadata httpGetEnabled-"true" httpsGetEnabled-"true" /> 


(5) 运行 该 应 用 程序 。WCF alin Pi EE AP US SAN OR e 

(6) 在 测试 客户 端 程序 的 左 窗 格 上 双击 Config File。 用 于 访问 服务 的 配置 文件 就 会 显示 在 右 窗 格 上 。 
(7) 在 左 窗 格 上 双击 GetDataUsingDataContractO 操 作 。 

(8) 在 右 窗 格 上 把 BoolValue 的 值 改 为 Tme，StringValue 的 值 改 为 Test String， 由 单 击 Invoke. 
(9) 如 果 显 示 了 安全 提示 对 话 框 ， 单 击 OK 按钮 确认 把 信息 友 送 给 服务 。 

(10) 显示 操作 的 结果 ， 如 图 24-2 所 示 。 


ED WCF Test Client 


File Tools Help 
c- My Service Projects GetDataUsingDataCortract 
2-368 http:/Aocalhost:53573/Service1.svc 
=}-"9 IService1 (BasicHitpBinding_|Service) Request 
: if GetData() 
: ff) GetDataAsync() Name Value Type 
|. GetDataUsingDataContract() 4 composite Ch24Ex01 Composite Type Ch24Ex01 Composite Type 


j Get Data Using DataContract Async BoolValue False system Boolean 
:| Config File String Value (null) 


Formatted XML 


Service added successfully. 


图 24-2 


(11) 在 的 部 单 击 XML 标签 页 ， 查 看 请 求 和 啊 应 的 XML. 
(12) 关闭 WCF 测试 客户 闯 程 序 ， 这 会 停止 Visual Studio 中 的 调试 。 


示例 说 明 

这 个 示例 使 用 WCF 汕 试 客户 靖 程 序 ， 在 上 一 个 示例 创建 的 服务 上 检查 和 调用 操作 。 玫 先 注意 ， 服 务 的 加 载 
有 一 点 儿 延 迟 ， 这 是 因为 测试 客户 端 程序 必须 检查 服务 ， 以 确定 其 功能 。 这 个 检查 过 程 使 用 与 Add Service 
Reference 工 具 相 同 的 元 数据 ， 所 以 必须 确保 元 数据 是 可 用 的 (在 上 一 个 示例 中 可 能 荣 用 了 元 数据 )。 检 查 完 毕 后， 
在 工具 的 左 窗 格 上 就 会 显示 服务 及 其 操作 。 

接 看 得 看 用 于 访问 服务 的 配置 。 与 上 一 个 示例 中 的 客户 站 应 用 程序 一 样 ， 这 些 配置 也 是 从 服务 的 元 数据 
中 上 自动 生成 的 ， 且 包含 在 与 服务 相同 的 代码 中 。 如 有 必要 ， 可 通过 该 工具 编辑 这 个 配置 文件 ， 方 法 是 右 击 
Config File 项 ， 单 击 Edit WCF Configuration. K| 24-3 是 该 配置 的 一 个 示例 ， 其 中 包含 本 章 前 面 提 到 的 绑 定 
配置 选项 。 
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C’\Users\ Majao\AppData\Local\ Tempi Test Client Projects\15.0\390cbb30-8d50-4b4a-8260-80 /c6 /a61ffT1\C... 


A Metadata 
日 - 国 Endpoints 


| L..LT] BasicHttpBinding IService1 

| - ill Bindings AlowCookies 

Close Timeout 
HostNameComparisonMode 
MaxBufferPoolSize 
MaxBufferSize 
MaxReceivedMessageSize 


Open Timeout 
Proxy Address 
Receive Timeout 
Send Timeout 
Text Encoding 
TransterMode 

Delete Binding Configuration UseDefault WebProxy 


| ice... 
M New MaxA woth 
Create a New Client... MaxBytesPerRead 


Name 
The name of the configuration of the binding. This name is used in a bindingConfiguration 
attribute to link an endpoint and its binding to a binding configuration. 


24-3 
UR vA Y — P ERIE. WP EAP IC A BE AINS AHA, AARAA, MAREA 
AN i 32 S FEAT Pm AI s REA SARS ATT AGS ABU XML, 这 些 信息 的 技术 性 很 强 , 但 在 调 
试 较 复 杂 的 服务 时 ， 这 些 信息 是 绝对 必需 的 。 
24.3.3 定义 WCF 服务 协定 


从 前 面 的 示例 可 以 了 解 到 ， 通 过 WCF 基础 结构 ， 可 以 结合 使 用 类 、 接 口 和 特性 来 方便 地 为 WCF 服务 定义 
协定 。 本 节 将 深入 介绍 这 种 技术 。 


1. 数据 协定 


要 给 服务 定义 数据 协定 ， 需 要 把 DataContractAttribute 特性 应 用 于 类 定义 。 这 个 特性 在 名 称 空间 
System.Runtime.Serialization 名 称 空间 中 。 可 使 用 表 24-3 所 示 的 属性 配置 它 。 


3& 24-3 DataContractAttribute 的 属性 


Bm 性 说 明 
用 不 同 于 类 定义 的 名 称 来 命名 数据 协定 。 这 个 名 称 在 SOAP 消息 和 服务 元 数据 定义 的 客户 端 数据 对 
象 上 使 用 
Namespace 定义 数据 协定 在 SOAP 消息 中 使 用 的 名 称 空间 
T 影响 序列 化 对 象 的 方式 。 如 果 设置 为 ttue， 那么 即使 多 次 引用 茶 个 对 象 实 例 , 仍然 只 序列 化 该 对 象 实 


例 一 次 ， 有 些 情 况 下 ， 这 可 能 非常 重要 。 默 认 值 是 false 


当 需 要 与 已 有 的 SOAP 消息 格式 交互 操作 时 ，Name 和 Namespace 属性 非常 重要 (其 他 协定 的 类 似 名 称 的 属 
性 也 是 同 理 )， 但 在 其 他 情况 下 很 可 能 不 需要 使 用 它们 。 

数据 协定 中 的 每 个 类 成 员 虱 必须 使 用 DataMemberAttribute 特性 , 它 在 名 称 空间 System. Runtime.Serialization 
中 。 这 个 特性 具有 表 24-4 所 示 的 属性 。 
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EmitDefaultValue 


2. 服务 协定 


表 24-4 DataMemberAttribute 的 属性 
说 PA 
指定 序列 化 时 数据 成 员 的 名 称 (默认 为 成 员 名 称 ) 
指定 成 员 是 否 必须 显示 在 SOAP TH iH 
int 值 ， 指 定 序列 化 或 反 序 列 化 成 员 的 顺序 ， 如 果 一 个 成 员 必 须 在 另 一 个 成 员 之 前 出 现 ， 这 个 顺序 就 
是 必需 的 。 先 处 理 Order 较 低 的 成 员 
将 其 设置 为 false 时 ， 如 果 成 员 的 值 是 默认 值 ， 就 禁止 该 成 员 包 含 在 SOAP TH As. PH 


把 System.ServiceModel.ServiceContractAttribute 特性 应 用 于 接口 定义 ， 就 定义 了 服务 协定 。 表 24-5 所 示 的 
属性 可 用 于 定制 服务 协定 。 


表 24-5 ServiceContractAttribute 的 属性 


属 性 vt R 
Name 按照 WSDL 中 <portType> 元 素 中 的 定义 ， 指 定 服务 协定 的 名 称 
Namespace 定义 WSDL 中 <portType> 元 素 使 用 的 服务 协定 的 名 称 空间 


ConfigurationName 在 配置 文件 中 使 用 的 服务 协定 名 称 
HasProtectionLevel FEARS ERR BA BE ARPA). RPR MEAAG, EAA 
ProtectionLevel 保护 级 别 ， 用 于 保护 消息 


SessionMode 


确定 是 否 为 消息 月 用 会 话 。 如 果 使 用 会 话 ， 束 可 以 确保 关联 到 发 送 给 服务 的 不 同 端点 的 消息 ， 即 它们 使 


用 同一 个 服务 实例 ， 因 此 可 以 共享 状态 


CallbackContract 


对 于 双 问 消息 传输 , 客户 端 提供 了 协定 和 服务 。 如 前 所 述 , 这 是 因为 双 同 通信 中 的 客户 端 也 用 作 服 务 嚣 。 


这 个 属性 允许 指定 客 忆 端 使 用 的 协定 


3. 操作 协定 


在 定义 服务 协定 的 接口 中 ， 应 用 System.ServiceModel.OperationContractAttribute 特性 ， 束 可 以 把 成 员 和 定义 
为 操作 。 这 个 特性 具有 表 24-6 所 示 的 属性 。 


属 性 


Name 


IsOneWay 
AsyncPattem 


HasProtectionLevel 
ProtectionLevel 
IsInitiating 
IsTerminating 


Action 


ReplyAction 


$ 24-6 OperationContractAttribute 的 属性 
说 明 

指定 服务 操作 的 名 称 。 默 认为 成 员 名 称 
指定 操作 是 否 返 回 一 个 响应 。 如 果 把 它 设置 为 tue， 则 客户 端 不 等 待 操作 完成 ， 就 会 继续 执行 
如 果 设 置 为 tue， 操 作 就 会 实现 为 两 个 方法 : BegincmethodName» (yl End<methodName>(), IAMA 
法 可 用 于 异步 调用 操作 
参见 表 24-5 
参见 表 24-5 
如 果 使 用 会 话 ， 这 个 属性 就 确定 调用 这 个 操作 是 否 可 以 局 动 新 会 话 
如 果 使 用 会 话 ， 这 个 属性 就 确定 调用 这 个 操作 是 否 会 中 断 当前 会 话 


如 果 使 用 寻 址 功能 (WCF 服务 的 一 个 高 级 功能 ), 操作 就 有 一 个 关联 的 动作 名 称 , 通过 这 个 属性 可 以 指 


定 该 名 称 
同上 ， 但 为 操作 的 响应 指定 动作 名 称 
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注意 : 

在 添加 一 个 服务 引用 时 ,无论 AsyncPattern 是 否 设 置 为 true, Visual Studio 都 会 生成 用 于 调用 该 服务 的 异步 
代理 方法 。 这 些 方法 带 有 后 组 Asynce， 它 们 使 用 了 .NET 4.5 中 新 引入 的 异步 技术 ， 并 且 只 是 从 调用 代码 的 角度 
看 才 是 异步 的 。 在 内 部 ， 它 们 调用 的 是 同步 的 WCF 操作 。 


4. 消息 协定 


前 面 的 示例 中 没有 使 用 消息 协定 规范 。 如 果 使 用 消息 协定 ， 就 应 定义 一 个 表示 消息 的 类 ， 再 给 类 应 用 
MessageContractAttribute 特 性 。 接 看 给 这 个 类 的 成 员 应 用 MessageBodyMemberAttribute、MessageHeaderAttribute 
或 MessageHeaderArrayAttribute 特 性 。 所 有 这 些 特 性 都 在 System.ServiceModel 名 称 空间 中 。 除 非 要 融 度 控制 WCF 
服务 使 用 的 SOAP 消 奶 ， 否 则 一 般 不 会 使 用 消 晨 协定 ， 所 以 这 里 不 详细 讨论 它 。 


5. 误 协定 
如 果 客 户 问 应 用 程序 可 以 使 用 特定 的 异常 类 型 ， 如 果 定 制 异常 ， 就 可 以 给 可 能 生成 该 异常 的 操作 应 用 
System.ServiceModel.FaultContractAttribute 特性 。 


试 一 试 WCF 协定 : Ch24Ex02Contracts 


(1) 在 C:\BeginningCSharp7\Chapter24 目录 中 创建 一 个 新 的 WCEF 服务 应 用 程序 项 目 Ch24Ex02. 

(2) 给 解决 方案 添加 一 个 类 库 项 目 Ch24Ex02Contracts， 删 除 Classl.cs 文件 。 

(3) 在 Ch24Ex02Contracts 项 目 中 添加 对 System.Runtime.Serialization.dll 和 System.ServiceModel.dll 程序 集 的 
引用 。 

(4) 在 Ch24Ex02Contracts 项 目 中 添加 Person 类 ， 修 改 Person.cs 中 的 代码 ， 如 下 所 示 : 


using System.Runtime.Serialization; 


namespace Ch24Ex02Contracts 
{ 

[DataContract] 

public class Person 


[DataMember ] 
public string Name { get; set; } 
[DataMember] 
public int Mark { get; set; } 
} 


} 
(5) 在 Ch24Ex02Contracts 项 目 中 添加 LAwardService 接口 ， 修 改 LAwardService.cs 中 的 代码 ， 如 下 所 示 : 
using System.ServiceModel; 


namespace Ch24Ex02Contracts 

{ 
[ServiceContract (SessionMode = SessionMode.Required) ] 
public interface IAwardService 


{ 
[OperationContract (IsOneWay = true, IsInitiating = true) ] 
void SetPassMark(int passMark); 
[OperationContract] 
Person[] GetAwardedPeople(Person[] peopleToTest); 
} 
} 


(6) 在 Ch24Ex02 项 目 中 ， 添 加 对 Ch24Ex02Contracts 项 目的 引用 。 
(7) 删除 Ch24Ex02 项 目 中 的 IServicel.cs 和 Servicel.sve. 

(8) 在 Ch24Ex02 中 添加 一 个 新 的 WCF 服务 AwardService。 

(9) 删除 Ch24Ex02 项 目 中 的 IAwardService.cs 文件 。 

(10) 修改 AwardService.sve.cs 文件 中 的 代码 ， 如 下 所 示 : 


using System.Collections.Generic; 
using Ch24Ex02Contracts; 
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namespace Ch24Ex02 
public class AwardService : IAwardService 
i private int passMark; 
public void SetPassMark (int passMark) 
this.passMark = passMark; 


} 
public Person[] GetAwardedPeople(Person[] peopleToTest) 
{ 
List<Person> result = new List<Person>(); 
foreach (Person person in peopleToTest) 
{ 
if (person.Mark > passMark) 


result.Add (person); 
} 
} 
return result.ToArray(); 
} 
} 
} 


(11) 修改 Web.config 中 的 服务 配置 段 ， 如 下 所 示 : 


<system.serviceModel> 
<protocolMapping> 
<add scheme="http" binding="wsHttpBinding" /> 
</protocolMapping> 


</system.serviceModel> 


(12) 打开 Ch24Ex02 的 项 目 属 性 。 在 Web 段 ， 记 住宿 主 设置 中 使 用 的 端口 号 。 如 果 尚 未 安装 IS， 则 可 以 


在 Visual Studio Development Server 中 设置 一 个 特定 的 端口 。 
(13) 在 解决 方案 中 添加 一 个 新 的 控制 台 项 目 Ch24Ex02Client， 把 它 设 置 为 局 动 项 目 。 
(14) 在 Ch24Ex02Client 项 目 中 添加 对 System.ServiceModel.dll 程序 集 和 Ch24Ex02Contracts 项 目的 引用 。 
(15) 在 Ch24Ex02Client 项 目 中 修改 Program.cs 中 的 代码 ， 如 下 所 示 ( 确 保 使 用 了 前 和 面 在 EndpointAddress 构 造 
国 数 中 获得 的 器 口 号 ， 示 例 代 码 使 用 了 59558): 


using static System.Console; 
using System.ServiceModel; 
using Ch24Ex02Contracts; 


namespace Ch24Ex2Client 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
Person[] people = new Person[] 
{ 
new Person { Mark 
new Person { Mark 
new Person { Mark 
new Person { Mark 
J; 
WriteLine ("People:"); 
OutputPeople (people); 
IAwardService client = ChannelFactory<IAwardService>.CreateChannel ( 
new WSHttpBinding(), 
new EndpointAddress ("http://localhost:59558 /AwardService.svc")); 
client.SetPassMark(70); 
Person[] awardedPeople = client.GetAwardedPeople (people); 
WriteLine (); 
WriteLine ("Awarded people:"); 
OutputPeople (awardedPeople); 
ReadKey () ; 
} 
static void OutputPeople(Person[] people) 
{ 
foreach (Person person in people) 
WriteLine("[0], mark: {1}", person.Name, person.Mark); 


46, Name-"Jim" ], 
73, Name-"Mike" }, 
92, Name-"Stefan" ], 
24, Name-"Arthur" } 
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} 
} 
} 
(16) 如 果 使 用 了 IIS， 直 接 运 行 应 用 程 厅 即 可 。 如 果 使 用 了 开发 服务 器 ， 必 须 确保 该 服务 的 开发 服务 器 正 
在 运行 ， 所 以 需要 首先 运行 服务 项 目 。 为 此 ， 可 将 Ch24Ex02 项 目 设 置 为 启动 项 目 ， 然 后 按 Ctrl + FS 键 。 这 将 
局 动 该 服务 ,但 不 进行 调试 。 然后 把 Ch24Ex02Client 项 目 设置 为 月 动 项 目 ， 再 按 下 FS 键 。 结果 如 图 24-4 所 示 。 


图 24-4 


示例 说 明 

这 个 示例 在 类 库 项 目 中 创建 了 一 系列 协定 ， 在 WCF 服务 和 客户 端 程序 中 使 用 了 这 个 类 库 。 与 前 面 的 示例 
一 样 ， 这 个 服务 也 驻 留 在 Web 服务 器 上 。 这 个 服务 的 配置 也 被 减少 到 最 低 程 度 。 

在 这 个 示例 中 ， 主 要 区 别 是 客户 冰 程 序 不 需要 元 数据 ， 因 为 客户 疹 程 序 可 以 访问 协定 程序 集 。 客 户 疹 程序 
不 是 从 元 数据 中 生成 一 个 代理 类 ， 而 是 通过 另 一 种 方法 获得 服务 协定 接口 的 引用 。 这 个 示例 中 另 一 个 值得 注意 
的 地 方 是 使 用 会 话 维护 服务 中 的 状态 ， 这 需要 WSHttpBinding 绑 定 ， 而 不 是 BasicHttpBinding 绑 定 。 

这 个 示例 使 用 的 数据 协定 是 一 个 简单 的 类 Person， 它 有 一 个 string 属性 Name 和 一 个 int 属性 Mark. f FH 
的 DataContractAttribute 特性 和 DataMemberAttribute 特性 没有 进行 定制 。 

定义 服务 协定 时 ， 给 LAwardService 接口 应 用 了 ServiceContractAttribute 特性 。 这 个 特性 的 SessionMode 属性 
设置 为 SessionMode.Required， 因 为 这 个 服务 需要 状态 : 


[ServiceContract (SessionMode=SessionMode. Required) ] 
public interface IAwardService 


{ 
第 一 个 操作 协定 SetPassMark0O 设 置 状 态 ， 因 此 其 OperattonContractAttribute 的 IsInitiating 属性 设置 为 true。 
这 个 操作 不 返回 任何 值 ， 所 以 将 IsOneWay 设置 为 tue， 把 操作 定义 为 单 向 操作 : 


[OperationContract (IsOneWay=true, IsInitiating=true) ] 
void SetPassMark(int passMark); 


73 — “ERIE DPE GetAwardedPeopleO 不 需要 进行 任何 定制 ， 使 用 前 面 定义 的 数据 协定 : 


[OperationContract] 
Person[] GetAwardedPeople (Person[] peopleToTest); 
} 


这 两 个 类 型 Person 和 LAwardService filiu] UAH FARA AIA P mE. ARGS TE AwardService 类 型 中 实现 了 
IAwardService 协定 ， 它 不 包含 任何 特殊 代码 。 这 个 类 与 前 面 的 服务 类 的 唯一 区 别 是 ， 这 个 类 是 有 状态 的 。 这 是 
允许 的 ， 因 为 定义 了 一 个 会 话 ， 来 关联 来 自 客户 端 程序 的 消息 。 

为 确保 服务 使 用 wsHttpBinding 绑 定 ， 给 服务 添加 了 如 下 Web.config: 

<protocolMapping> 
«add scheme-"http" binding-"wsHttpBinding" /> 
«/protocolMapping- 

这 重 写 了 HTIP AENEAN. AS, Ea AFARS, RECARE. (kp RS NACE 
要 重音 得 多 。 注 意 此 类 重 写 配置 会 应 用 于 项 目 中 的 所 有 服务 。 如 果 项 目 中 有 多 个 服务 ， 束 必须 确保 每 个 服务 都 
能 接受 这 个 绑 定 。 
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客户 端 程序 比较 有 趣 ， 主 要 是 因为 下 面 这 行 代码 ; 
IAwardService client = ChannelFactory<IAwardService>.CreateChannel ( 


new EndpointAddress ("http://localhost:38831/AwardService.svc")); 


Z Phin FIERE 2C Flapp.config xc (FRAC SARS NI, € A MCB Pe MRE ARS RFE - 
i 71 ChannelFactory<T>.CreateChannel() 77 13: G] EREK., 3X0 Jj 1 S — Se Wl AwardService% FP "m FE 
FIREX, (AER AINA SARS, BR BU Dc URS EIE] EE E. 


注意 : 

如 果 通 过 ChannelFactory<T>.CreateChannel0 方 法 创建 代理 类 ， 通 信 信 道 就 默认 为 在 1 分 钟 后 超时 ， 导 致 通 
信和 错误 。 使 连接 一 直 处 于 激活 状态 有 许多 方式 ， 但 这 些 都 超出 了 本 章 的 讨论 范围 。 

采用 这 种 方式 创建 代理 类 是 一 种 非常 有 用 的 技术 ， 可 以 快速 生成 客户 端 应 用 程序 。 


243.3 上 自 驻 留 的 WCF 服务 


本 章 前 面 介绍 了 驻 留 在 Web 服务 器 上 的 WCF 服务 。 它 们 可 以 在 Internet. 上 通信 ， 但 对 于 本 地 网 络 通信 而 
言 ， 这 并 不 是 最 高 效 的 方式 。 一 方面 ， 需 要 用 计算 机 上 的 Web 服务 器 驻 留 服务 ; 另 一 方面 ， 在 应 用 程序 的 体系 
结构 上 出 现 一 个 独立 的 WCF 服务 可 能 并 不 合适 。 

因此 应 使 用 目 驻 留 的 WC RS. HERI WCF 服务 存在 于 创建 它 的 进程 中 , 而 不 存在 于 特别 建立 的 主机 
应 用 程序 (如 Web 服务 器 ) 的 进程 中 。 这 意味 着 可 以 使 用 控制 台 应 用 程序 或 Windows 应 用 程序 驻 留 服务 了 。 

要 建立 目 驻 留 的 WCF 服务 ， 需 要 使 用 System.ServiceModel.ServieceHost 类 。 用 要 驻 留 的 服务 类 型 或 服务 
类 的 一 个 实例 来 实例 化 这 个 类 。 通 过 属性 或 方法 可 以 配置 服务 答 主 ， 也 可 以 通过 配置 文件 来 配置 。 实 际 上 ， 窒 
主 进程 (如 Web 服务 右 ) 使 用 ServiceHost 实例 执行 该 驻 留任 务 。 目 驻 留 时 ， 区 别 是 直接 与 这 个 类 交互 操作 。 但 
在 答 主 应 用 程序 的 app.config 文件 中 , <system.serviceModel> 段 中 的 配置 使 用 的 语法 与 本 章 前 面 的 配置 段 中 的 
相同 。 

可 以 通过 任意 协议 提供 目 驻 留 的 WCF 服务 ,但 是 一 般 在 这 种 类 型 的 应 用 程序 中 使 用 TCP Bt 4 REE - 
通过 HTTP WARS tss T Web ARS aE HA, ALAA] PAX 13 Web 服务 器 提供 的 额外 功能 ， 如 安全 性 等 。 

如 果 要 驻 留 MyService 服务 ， 可 使 用 下 面 的 代码 创建 ServiceHost 的 一 个 实例 : 


ServiceHost host = new ServiceHost (typeof (MyService)); 


如 果 要 驻 留 MyService 的 实例 MyServiceObject， 可 以 编写 如 下 人 代码， 创建 ServiceHost 的 一 个 实例 : 


MyService myServiceObject = new MyService(); 
ServiceHost host = new ServiceHost (myServiceObject); 


警告 : 

只 有 配置 了 服务 ， 使 调用 总 是 可 以 路 由 到 同一 个 对 象 实例 上 ， 才 能 在 ServiceHost 中 驻 留 服务 实例 。 为 此 ， 
必须 给 服务 类 应 用 ServiceBehaviorAttribute 特性 ， 将 这 个 特性 的 InstanceContextMode 属性 设置 为 
InstanceContextMode.Single. 


创建 ServiceHost 实例 后 , HA) E8833 Js E BO IRS e Fm BE 737b. 如 果 把 配置 放 在 .config 文件 中 ， 
将 会 日 动 配置 ServiceHost 实例 。 

有 了 配置 好 的 ServiceHost 实例 后 ， 为 了 开始 驻 留 服务 ， 应 使 用 ServiceHostOpen0 方 法 。 同 样 ， 通 过 
ServiceHost.Close0 方 法 可 以 停止 驻 留 服务 。 第 一 次 驻 留 TCP 绑 定 的 服务 时 ， 如 果 局 用 它 ， 可 能 收 到 Windows 
防火 墙 服 务 发 出 的 一 个 警告 ， 因 为 它 阻塞 了 默认 的 TCP 端口 。 只 有 给 这 个 服务 打开 TCP 端口 ， 才 能 开始 监听 
该 端口 。 

下 例 使 用 目 驻 留 技术 通过 WCF 服务 提供 WPF 应 用 程序 的 一 些 功 能 。 
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试 一 试 ” 自 驻 留 的 WCF 服务 : Ch24Ex03 


(1) Œ C:\BeginningCSharp7\Chapter24 目录 中 创建 一 个 新 的 WPF 应 用 程序 Ch24Ex03。 
(2) 使 用 Add New Item 回 导 给 项 目 添 加 一 个 新 的 WCF 服务 AppControlService。 
(3) 修改 MainWindow.xaml.es 中 的 代码 ， 如 下 所 示 : 


«Window x:Class-"Ch24Ex03.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
xmlns:local-"clr-namespace:Ch24Ex03" 

Loaded-"Window Loaded" Closing-"Window Closing" 
Title-"Stellar Evolution" Height="450" Width="430" 
mc:lIgnorable-"d"» 
«Grid Height="400" Width="400" HorizontalAlignment-"Center" 
VerticalAlignment-"Center"- 
«Rectangle Fill-"Black" RadiusX-"20" RadiusY-"20" 
StrokeThickness-"10"» 
«Rectangle.Stroke- 
<LinearGradientBrush EndPoint-"0.358,0.02" 
StartPoint="0.642,0.98"> 
<GradientStop Color-"4FF121A5D" offset="0" /> 
<GradientStop Color="#FFBIB9FF" Offset="1" /> 
</LinearGradientBrush> 
</Rectangle.Stroke> 
</Rectangle> 
«Ellipse Name-"AnimatableEllipse" Stroke-"[x:Null]" Height="0" 
Width="0" HorizontalAlignment-"Center" 
VerticalAlignment="Center"> 
«Ellipse.Fill- 
<RadialGradientBrush> 
<GradientStop Color="#FFFFFFFF" Offset="0" /> 
<GradientStop Color-"4FFFFFFFF" Offset="1" /> 
</RadialGradientBrush> 
«/Ellipse.Fill» 
<Ellipse.Effect> 
«DropShadowEffect ShadowDepth="0" Color-"4FFFFFFFF" 
BlurRadius-"50" /> 
«/Ellipse.Effect-» 
</Ellipse> 
</Grid> 
</Window> 


(4) 修改 MainWindow.xaml.cs 中 的 代码 ， 如 下 所 示 : 


using System; 

using System.Windows; 

using System.Windows.Media; 

using System.Windows.Shapes; 

using System.ServiceModel; 

using System.Windows.Media.Animation; 


namespace Ch24Ex03 
{ 
public partial class MainWindow : Window 
{ 

private AppControlService service; 

private ServiceHost host; 

public MainWindow () 

{ 
InitializeComponent (); 

} 

private void Window Loaded(object sender, RoutedEventArgs e) 

{ 
service = new AppControlService (this); 
host = new ServiceHost (service); 
host.Open(); 

} 

private void Window Closing(object sender, 
System.ComponentModel.CancelEventArgs e) 

{ 
host.Close(); 

} 

internal void SetRadius (double radius, string foreTo, 
TimeSpan duration) 
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if (radius > 200) 
i 
radius - 200; 
} 
Color foreToColor = Colors .Red; 
try 
{ 
foreToColor = (Color)ColorConverter.ConvertFromString(foreTo); 
} 
catch 
{ B = 
// Ignore color conversion failure. 
} 
Duration animationLength = new Duration (duration); 
DoubleAnimation radiusAnimation = new DoubleAnimation ( 
radius * 2, animationLength) ; 
ColorAnimation colorAnimation - new ColorAnimation( 
foreToColor, animationLength); 
AnimatableEllipse.BeginAnimation (Ellipse.HeightProperty, 
radiusAnimation) ; 
AnimatableEllipse.BeginAnimation (Ellipse.WidthProperty, 
radiusAnimation); 
((RadialGradientBrush)AnimatableEllipse.Fill).GradientStops[l] 
.BeginAnimation(GradientStop.ColorProperty, colorAnimation); 
} 
} 
} 


(5) 修改 LAppControlService.cs 中 的 代码 ， 如 下 所 示 : 


[ServiceContract] 
public interface IAppControlService 
{ 
[OperationContract] 
void SetRadius (int radius, string foreTo, int seconds); 


} 
(6) 修改 AppControlService.cs 中 的 代码 ， 如 下 所 示 : 


[ServiceBehavior (InstanceContextMode-InstanceContextMode.Single)] 
public class AppControlService : IAppControlService 
{ 

private MainWindow hostApp; 

public AppControlService (MainWindow hostApp) 

{ 

this.hostApp = hostaApp; 
} 


public void SetRadius (int radius, string foreTo, int seconds) 
{ 
hostApp.SetRadius (radius, foreTo, new TimeSpan(0, 0, seconds)); 
} 
} 


(7) 修改 app.config 中 的 代码 ， 如 下 所 示 : 


<configuration> 
<startup> 
«supportedRuntime version-"v4.0" sku-".NETFramework,Version-v4.5.2" /> 
</startup> 
<system.serviceModel> 
<services> 
<service name="Ch24Ex03.AppControlService"> 
«endpoint address-"net.tcp://localhost:8081/AppControlService" 
binding-"netTcpBinding" 
contract-"Ch24Ex03.IAppControlService" /> 
</service> 
</services> 
</ system. serviceModel> 
</configuration> 


(8) 在 项 目 中 添加 一 个 新 的 控制 台 应 用 程序 Ch24Ex03Client. 

(9) 在 Solution Explorer 中 右 击 解 决 方 案 ， 单 击 Set StartUp Projects。 

(10) 配置 解决 方案 ， 使 其 有 多 个 局 动 项 目 ， 让 多 个 项 目 同 时 启动。 

(11) 在 Ch24Ex03Client 项 目 中 添加 对 System.ServiceModel.dll 和 Ch24Ex03 的 引用 。 
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(12) 修改 Program.cs 中 的 代码 ， 如 下 所 示 : 
using Ch24Ex03; 
using System. ServiceModel; 


using static System.Console; 


namespace Ch24Ex03Client 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
WriteLine ("Press enter to begin."); 
ReadLine(); 
WriteLine("Opening channel."); 
IAppControlService client - 
ChannelFactory«IAppControlService-.CreateChannel( 
new NetTcpBinding(), 
new EndpointAddress( 
"net.tcp://localhost:8081/AppControlService")); 
WriteLine("Creating sun."); 
client.SetRadius (100, "yellow", 3); 
WriteLine("Press enter to continue."); 
ReadLine(); 
WriteLine("Growing sun to red giant."); 
client.SetRadius (200, "Red", 5); 
WriteLine("Press enter to continue."); 
ReadLine(); 
WriteLine("Collapsing sun to neutron star."); 
client.SetRadius(50, "AliceBlue", 2); 
WriteLine("Finished. Press enter to exit."); 
ReadLine(); 
} 
} 
} 


(13) 运行 解决 方案 。 出 现 提示 时 ， 打 开 Windows 防火 墙 TCP 端口 ， 使 WCE 可 以 监听 连接 。 
(14) 显示 Stellar Evolution 窗口 和 控制 台 应 用 程序 窗口 时 ， 在 控制 台 窗 口中 按 下 回 车 键 。 结 果 如 图 24-5 
所 示 。 


8 ' D:\Book\2017 EdrtonvChodCodevChapter24Ch2dEx03vCh2dFx03Client 一 


E" Stellar Evolution 
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(15) 在 控制 台 窗 口中 继续 按 下 回 车 键 ， 继 续 星 体 演 化 循环 。 
(16) XH] Stellar Evolution 窗口 ， 停 止 调试 。 


示例 说 明 

该 示例 在 WPF 应 用 程序 中 添加 了 一 个 WCF 服务 ， 用 它 控 制 Ellipse 控件 的 动画 。 我 们 创建 了 一 个 简单 客 
户 端 应 用 程序 来 测试 服务 。 如 果 不 熟悉 WPF， 不 必 过 多 考虑 示例 中 的 XAML 代码 ， 我 们 只 对 WCF 感 兴趣 。 

WCE 服务 AppControlService 有 一 个 操作 SetRadiusO， 客 户 吕 程序 调用 这 个 操作 来 控制 动画 。 这 个 方法 
与 它 同 名 的 方法 通信 ， 同 名 方法 在 WPF 应 用 程序 的 Windowl 类 中 定义 。 为 此 ， 服 务必 须 引 用 应 用 程序 ， 所 以 
必须 驻 留 该 服务 的 一 个 对 象 实 例 。 如 前 所 述 ， 这 意味 看 服务 必须 使 用 行为 特性 : 

[ServiceBehavior (InstanceContextMode=InstanceContextMode.Single) ] 

ae class AppControlService : IAppControlService 

cee 

在 Window1.xaml.cs 中 ， 在 Windows Loaded0 事 件 处 理 程序 中 创建 服务 实例 。 这 个 方法 也 为 服务 创建 了 一 
个 ServiceHost 对 象 ， 并 调用 了 其 Open0 方 法 ， 以 便 开 始 驻 留 : 


public partial class Windowl : Window 


private AppControlService service; 
private ServiceHost host; 


private void Window Loaded(object sender, RoutedEventArgs e) 


service = new AppControlService (this); 
host = new ServiceHost (service); 
host .Open(); 
} 
在 Window Closing0 事 件 处 理 程序 中 ， 应 用 程序 关闭 时 ， 驻 留 过 程 中 断 。 
配置 文件 非常 简单 ， 它 定义 了 WOCEF 服务 的 一 个 端点 ， 监 听 端 口 8081 的 nettcp 地 址 ， 使 用 默认 的 NetTep- 
Binding 绑 定 : 
«service name-"Ch24Ex03.AppControlService"- 
«endpoint address-"net.tcp://localhost:8081/AppControlService" 
binding-"netTcpBinding" 


contract-"Ch24Ex03.IAppControlService" /> 
</service> 
+ " EL 一 全- — | ^" TTI 
X 5j Pi YF Ee APS SF: 
TAppControlService client = 
ChannelFactory«IAppControlService».CreateChannel( 
new NetTcpBinding(), 


new EndpointAddress( 
"net.tcp://localhost:8081/AppControlService")); 


客户 端 程序 创建 客户 代理 类 时 ， 可 以 调用 SetRadius0 方 法 ， 给 它 传递 半径 、 颜 色 和 动画 持续 时 间 等 参数 ， 
这 些 都 会 通过 服务 转发 给 WPF 应 用 程序 。 接 着 ，WPF 应 用 程序 中 的 简单 代码 定义 并 使 用 动画 ， 来 改变 椭圆 的 
大 小 和 颜色 。 

如 果 使 用 一 个 计算 机 名 ， 而 不 是 localhost， 并 且 网 络 允 许 在 指定 的 端口 上 通信 ， 这 段 代码 就 可 以 在 网 络 上 
工作 。 另外, 还 可 进一步 分 离 客户 端 程序 和 宿主 应 用 程序 ， 并 通过 Intemet 连接 起 来 。 无 论 采用 什么 方式 ，WCF 
服务 都 提供 了 很 好 的 通信 方式 ， 建 立 这 种 通信 不 需要 付出 过 多 努力 。 


244 习题 
(1) 下 面 哪些 应 用 程序 可 以 驻 留 WCF 服务 ? 


a. Web 应 用 程序 
b. Windows 窗 体 应 用 程序 
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c. Windows 服务 

d. COM+ 应 用 程序 

e. 控制 台 应 用 程序 

(2) 如 果 要 与 WCF 服务 交换 MyClass 类 型 的 参数 ， 应 实现 什么 类 型 的 协定 ?需要 什么 特性 ? 

(3) 如 果 把 WCF 服务 驻 留 在 Web 应 用 程序 中 ， 应 对 服务 使 用 的 基 问 点 进行 什么 扩展 ? 

(4) 在 自 驻 留 WCE 服务 时 ， 必 须 设置 ServiceHost 类 的 属性 ， 调 用 它 的 方法 ， 来 配置 服务 。 对 吗 ? 

(5) 提供 服务 协定 MusicPlayer INAS, CEM f Play0、Stop0 和 GetTrackmformnation0 操 作 。 在 合适 的 地 
方 使 用 单 回 方法 。 还 要 为 这 个 服务 定义 其 他 什么 协定 ? 

附录 A 给 出 了 习题 答案 。 
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+ S 要 点 
wera | WCF 提供 了 创建 远程 服务 并 与 其 通信 的 框架 ， 它 合并 了 Web 服务 和 远程 技术 体系 结构 的 元 素 , 并 使 用 新 技术 来 达 
075 [| 到 该 目标 


可 以 通过 几 个 协议 与 WCF 服务 通信 ,包括 HTTP 和 TCP。 这 表示 可 使 用 客户 端 应 用 程序 的 本 地 服务 ， 也 可 以 使 用 
其 他 计算 机 或 网 络 上 的 服务 。 为 此 ， 应 通过 对 应 于 该 协议 的 绑 定 及 需要 的 功能 ， 在 特定 的 端点 上 访问 该 服务 。 可 


— 以 通过 行为 控制 这 些 功 能 ， 例 如 使 用 会 话 状态 或 提供 元 数据 。.NET 包含 许多 默认 的 设置 ， 非 常 便于 定义 简单 的 
服务 

— 对 来 自 WCF 服务 的 响应 的 调用 一 般 编 码 为 SOAP 消息 。 也 可 以 使 用 普通 的 HITP 消息 ， 如 有 必要 ,还 可 以 从 头 开 
始 定义 自己 的 负载 类 型 

WCF 服务 可 驻 留 在 IIS 或 Windows 服务 中 , 也 可 以 是 目 驻 留 的 。 使 用 IIS 等 宿主 来 驻 留 WCF 服务 ,就 可 以 利用 该 
箱 主 内 置 的 功能 ， 包 括 安 全 性 和 应 用 程序 池 。 目 驻 留 比较 灵活 ， 但 可 能 需要 更 多 的 配置 和 编码 

协定 通过 协定 来 定义 WCF 服务 和 客户 代码 之 间 的 接口 。 服 务 及 其 提供 的 操作 是 通过 服务 和 操作 协定 来 定义 的 。 数 据 类 
型 用 数据 协定 来 定义 。 可 使 用 消息 协定 和 误 协 定 来 进一步 定制 通信 

安 户 端 应 客户 端 应 用 程序 与 WCF 服务 通过 代理 类 来 通信 。 代 理 类 为 服务 实现 了 服务 协定 接口 ， 对 这 个 接口 的 操作 方法 的 所 

用 程序 有 调用 都 重 定向 到 服务 上 。 可 使 用 Add Service Reference 工具 生成 代理 ,也 可 以 通过 信道 工厂 方法 以 编程 方式 创建 


代理 。 为 了 成 功 通信 ， 必 须 配 置 客户 端 程序 ， 以 匹配 服务 的 配置 


ze 


通用 应 用 程序 


REAR: 

e 支持 Windows 10 设备 进行 开发 

e {EH XAML 和 CHF A Windows 通用 应 用 程序 
e 使 用 常见 的 Windows 通用 应 用 程序 

e 打包 和 部 蜀 应 用 程序 


本 章 源 代码 可 以 通过 本 书 合 作 站 点 wrox.com 上 的 Download Code 选项 卡 下 载 ， 也 可 以 通过 网 址 
http://github.com/benperk/BeginningCSharp7 FR. 下载 代 码 位 于 Chapter25 文件 夹 中 并 已 根据 本 章 示 例 的 名 称 单 


很 容易 将 Windows 当成 是 PC 机 的 操作 系统 ， 但 实际 上 ，Windows 可 以 在 多 种 类 型 的 设备 上 运行 。 运 行 
Windows 的 大 部 分 设备 当然 是 PC, 但 Xbox 和 Surface 平板 上 也 运行 的 是 Windows， 这 还 包括 一 些 奇特 的 设备 ， 
如 HoloLens. 

通用 Windows 平台 (Universal Windows Platform，UWP) 为 开发 应 用 程序 提供 了 一 个 公共 基础 架构 ， 只 要 设 
备 上 能 够 运行 Windows 10， 惑 能 够 运行 使 用 这 个 公共 基础 殿 构 开 友 的 应 用 程序 。 这 样 就 可 以 只 构建 应 用 程序 一 
次 并 使 用 Windows Store 进行 发 布 ， 而 不 必 为 每 个 设备 类 型 都 构建 包 . 


25.1 准备 工作 


开始 编写 通用 应 用 程序 之 前 ， 需 要 先 做 一 些 准 备 工 作 。 在 Visual Studio 的 上 一 个 版 本 中 ， 必 须 先 获得 一 个 
Windows 8 JF VE nu], mu Hs eA» RH ix Ty nu]. Œ Windows 10 中 进行 开发 就 不 表 需 要 这 样 的 许可 ,但 是 
仍然 需要 创建 一 个 Windows Store 账户 , 以 便 能 够 发 布 应 用 程序 。 在 开发 应 用 程序 时 , 可 以 将 目 己 的 Windows 10 
设备 注册 成 开发 设备 。 

在 开始 编写 Windows 通用 应 用 程序 之 前 ， 必 须 在 设备 上 局 用 开 友 功能 ， 并 安装 Universal Windows App 
Development Tools( 如 果 还 没有 安装 的 话 )。 

在 Visual Studio 中 打开 一 个 解决 方案 来 创建 Windows 通用 应 用 程序 时 ， 可 能 会 看 到 图 25-1 所 示 的 对 话 框 ， 
提示 局 用 开发 者 模式 。 看 到 此 对 话 框 时 ， 单 击 For developers 链接 ， 选 择 Developer mode 选项 ， 此 时 会 弹出 警 
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告 ， 提 醒 你 选择 了 一 个 安全 性 较 弱 的 选项 ， 单 击 Yes 即 可 。 


For developers 


Use devel oper features Create your own Windows app 
Build a Universal Windows Platt 
These settings are intended for development use only. (UWP) app and share it with the 
Update & Security aan mene world through the Store, 
Get info about UWP apps 


Windows Update 
P O Windows Store apps 


- Only install apps from the Windows Store. 
Windows Defender deas : Have a question? 
©) Sideload apps Get help 
nstall apps from other sources that you trust, like your 


Workplace. 
Troubleshoot Make Windows better 


Backup 


(8) Developer mode Give us feedback 


Recove | 
y nstall any signed and trusted app and use advanced 


development features. 
Activation 
Find my device Enable Device Portal 


For developers Turn on remote diagnostics over local area network connections. 


@ off 


Windows Insider Program 
Device discovery 


Make your device visible to USB connections and your local 
network. 


@ ) of 


File Explorer 


Apply the following settings for a more developer friendly File 
Explorer. 


图 25-1 


注意 : 

开发 者 模式 有 三 种 选择 : Windows Store apps. Sideload apps 和 Developer mode. Windows Store apps 是 最 安 
全 的 设置 ， 应 该 总 是 启用 它 ， 除 非 你 自己 开发 应 用 。Developer mode 是 安全 性 最 低 的 选项 ， 仅 当 需 要 在 设备 上 
开发 和 调试 应 用 时 才 使 用 。Sideload apps 是 一 种 比较 安全 的 选择 ， 因 为 在 这 个 模式 下 ， 不 能 在 设备 上 安装 不 可 
信 的 应 用 ， 但 是 此 选项 不 允许 调试 应 用 。 


用 户 可 能 没有 安装 Universal Windows App Development Tools。 要 安装 它 ， 必 须 再 次 运行 Visual Studio 
Installer。 可 在 Start 菜单 中 输入 Visual Studio Installer 打开 安装 程序 。 在 看 到 已 安装 产品 列表 后 ， 单 击 Modify， 
选中 Universal Windows Platform development 复 选 枉 ， 最 后 册 次 单 击 Modify 来 安装 选中 的 选项 。 


25.2 Windows 通用 应 用 程序 


传统 的 应 用 程序 , 像 本 书 前 面 编 写 的 WPF 桌面 游戏 ,针对 单一 设备 类 型 ,比如 PC。. 引 入 了 Universal Windows 
Platform Ja, Microsoft 使 编写 出 能 够 运行 在 多 个 设备 上 的 单个 应 用 程序 成 为 可 能 ， 并 已 投入 了 许多 精力 ， 提 升 
开发 者 开发 这 种 应 用 程序 的 体验 。 

在 大 量 异 构 设 备 上 开发 应 用 程序 的 主要 挑战 是 ， 无 法 提前 得 知 屏幕 有 多 大 ， 或 用 户 将 如 何 与 设备 交互 。 如 
果 简 单 地 把 本 书 前 面 的 Karli Cards WPF 应 用 程序 放 在 平板 电脑 的 屏 磊 上 , 效果 会 很 糟 。 男 一 个 方面 是 平板 电脑 
用 户 希 望 应 用 程序 能 调整 它 在 屏幕 上 的 显示 方向 。 本 章 将 介绍 响应 UI 和 适应 性 触发 器 的 概念 ， 来 解决 这 些 
问题 。 

通用 应 用 程序 通过 Windows Store 部 署 ， 对 于 打包 应 用 程序 而 言 ， 这 有 其 日 映 的 挑战 。 为 将 应 用 程序 放 在 
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Windows Store 上 ， 必 须 经 历 一 个 相当 严格 的 测试 过 程 ， 并 通过 Microsoft 设 定 的 许多 要 求 。 本 和 章 最 后 将 讨论 这 
修 过 程 ， 以 便 你 发 布 目 己 的 应 用 程序 。 


注意 : 

AK “Windows 通用 应 用 程序 ”这 个 名 称 可 以 知道 ， 所 谓 的 “通用 ”， 实际 上 只 是 针对 运行 Windows 的 设备 。 
如 果 需 要 让 应 用 程序 运行 在 其 他 设备 上 ， 如 Android 或 iOS 的 手机 和 平板 电脑 ， 那 么 要 考虑 另 一 个 开发 平台 : 
Xamarin. Xamarin 允许 使 用 XAML 和 CHA Android 和 10S 设备 开发 应 用 程序 。 本 章 介 绍 的 许多 概念 也 适用 于 
Xamarin， 只 不 过 实现 细节 会 有 区 别 。 


25.3 ”应 用 程序 概念 和 设计 


应 用 程序 如 何在 平板 和 Windows 果 面 中 显示 有 痢 极 大 差异 。 运 行 在 Windows 果 面 上 的 应 用 程序 设计 在 很 
大 程度 上 是 不 变 的 ， 虽 然 因 为 Windows 95 的 引入 ， 这 种 应 用 程序 有 更 好 的 图 形 。 其 设计 特性 是 一 个 窗口 市 有 
标题 栏 ， 右 上 角 有 三 个 按钮 用 于 最 大 化 、 最 小 化 、 关 闭 应 用 程序 ， 还 包 侣 按钮 、 单 选 按钮 、 复 选 框 等 来 : 显示 内 
容 。 引 入 Windows 8 后 ， 应 用 程序 的 生成 稍 有 不 同 。 它 们 通过 和 触摸 来 工作 ， 而 不 是 鼠标 和 键盘 ， 标 题 栏 可 能 有 ， 
也 可 能 没有 ， 可 以 旋转 ， 以 适应 运行 它们 的 设备 的 方 同 ， 这 只 是 几 个 差异 。 

Microsoft 针对 UWP 应 用 程序 发 布 了 一 个 相当 详细 的 应 用 设计 指南 ， 即 使 不 必 坚 持 使 用 它 ， 也 应 该 知道 有 这 个 
指责。 尽管 应 用 程序 运行 在 各 种 设备 上 , 但 它们 有 许多 共同 的 特征 。 所 以 下 面 介 绍 一 些 共 同 特征 , 看 看 Windows 
Store 应 用 程序 如 何 和 果 面 应 用 程序 匹配 。 


注意 : 
UWP 应 用 程序 设计 指南 可 以 通过 https://developer.microsoft.com/en-US/windows/apps/design 下 载 。 


25.3.1 屏幕 方向 


所 有 Windows 应 用 程序 都 应 能 优雅 地 调整 目 己 的 大 小 。 特别 重要 的 一 个 方面 是 手持 设备 可 以 在 三 维 空间 中 
移动 。 用 户 会 期 竺 应 用 程序 随 着 屏幕 的 方 回 来 移动 。 因 此 ， 如 果 用 户 倒 转 平 板 电 脑 ， 应 用 程序 应 该 随 之 倒转 。 


25.3.2 3M TRE 


经 典 桌面 应 用 程序 使 用 菜单 和 工具 栏 在 视图 之 间 导 航 。 通 用 应 用 程序 也 可 以 这 样 做 ， 但 它们 更 有 可 能 使 用 
工具 栏 ， 而 不 是 菜单 。 桌 面 应 用 程序 通常 总 是 显示 菜单 和 工具 栏 的 可 视 化 组 件 ， 但 是 通用 应 用 程序 往往 会 选择 
不 这 样 做 ， 以 在 较 小 的 屏幕 上 节省 宝贵 的 空间 。 

不 是 强迫 用 户 通过 菜单 发 现 应 用 程序 的 复杂 性 ， 应 用 程序 风格 把 应 用 程序 呈现 给 用 户 ， 他 们 可 以 在 需要 的 
时 候 激活 菜单 。 当 菜单 显示 出 来 时 ， 应 该 很 简单 ， 只 包含 主 选项 。 由 用 户 来 决定 何 时 何 地 显示 菜单 。 


25.3.3 ” 磁 贴 和 徽章 


Windows 使 用 活动 磁 贴 Live tile) 在 Start 六 单 和 页 面 上 显示 应 用 程序 。 该 名 称 中 的 “活动 ” 源 于 如 下 事实 : 
磁 贴 可 以 基于 应 用 程序 的 当前 内 容 或 状态 而 改变 。 例 如， 照片 应 用 程序 会 旋转 Start 页 面 上 的 照片 ， 邮 件 客户 端 
显示 未 读 邮件 的 数量 ， 游 戏 显 示 上 次 保存 的 截图 等 。 这 种 可 能 性 几乎 是 无 止境 的 。 

为 应 用 程序 提供 好 的 磁 贴 比 为 应 用 程序 吕 面 提供 好 的 图 标 更 重要 ， 这 非常 重要 。 磁 贴 舱 在 应 用 程序 的 清单 
里 ， 参 见 本 章 稍 后 的 内 容 ， 使 用 Visual Studio 很 容易 包括 它们 。 

和合 章 (badge) 是 倍 贴 的 一 个 小 版本 ，Windows 可 在 锁定 屏 基 和 其 他 情况 下 使 用 它 。 不 需要 为 应 用 程序 提供 徽 
5, 除非 要 在 Lock Screen 上 显示 通知 。 
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25.3.4 应 用 程序 的 生存 期 


经 典 的 Windows 桌面 应 用 程序 可 以 通过 单 击 标题 栏 右上 角 的 一 个 按钮 来 关闭 , 但 通用 应 用 程序 通常 不 显示 
标题 栏 ， 那 么 该 如 何 关闭 它 ? 一 般 来 说 ， 不 需要 关闭 通用 应 用 程序 。 只 要 通用 应 用 程序 失去 焦点 ， 就 会 挂 起 ， 
并 完全 停止 使 用 处 理 器 资源 。 这 就 允许 许多 应 用 程序 同时 运行 ， 而 事实 上 它们 只 是 暂停 。 在 Windows 中 ， 应 用 
程序 失去 焦点 ， 就 会 自动 暂停 。 用 户 并 未 真正 注意 到 ， 但 应 用 程序 开发 人 员 应 该 认识 到 这 个 非常 重要 的 事实 ， 
并 处 理 它 。 


25.3.5 ” 锁 屏 应 用 程序 


一 些 应 用 程序 失去 焦点 时 应 该 继续 运行 。 这 种 应 用 程序 的 示例 包括 GPS 导航 和 音频 流 应 用 。 即 使 用 户 开 始 
开车 或 开始 使 用 其 他 应 用 程序 ， 也 和 希望 这 类 应 用 程序 继续 运行 。 如 果 应 用 程序 需要 继续 在 后 台 运 行 ， 束 必须 把 
它 声明 为 Lock Screen( 锁 屏 ) 应 用 程序 ， 并 提供 信息 ， 以 便 在 Lock Screen 上 显示 通知 。 


25.4 ”应 用 程序 的 开发 


开始 开发 Windows 通用 应 用 程 订 时 ,有 很 多 关于 编程 和 UI 语言 的 选择 。 本 书 使 用 C# 和 XAML， 其 他 选项 
包括 JavaScript 和 HIML5、C++ 和 DirectX 或 Visual Basic 和 XAML。 

用 于 创建 通用 应 用 程序 用 户 界 面 的 XAML, 5 WPF 使 用 的 XAML 并 不 完全 相同 ， 但 它们 足够 接近 ， 使 
用 起 来 应 感到 得 心 应 手 。 很 多 熟悉 的 控件 也 存在 于 通用 应 用 程序 ,但 它们 的 外 观 与 Windows 果 面 的 相应 控件 略 
有 不 同 ， 还 有 许多 为 触摸 进行 了 优化 的 控件 。 


25.4.1 AEMET 


目 适 应 显示 指 显 示 的 内 容 能 啊 应 用 户 行 为 的 变化 ， 如 于 机 翻 到 一 出， 或 者 窗口 改变 大 小 。 当 用 户 翻 转手 机 
时 ， 应 用 程序 应 能 够 优雅 地 从 纵 回 模式 切换 到 横 辣 模式 ， 应 用 程序 在 所 有 设备 上 属 能 很 好 地 工作 。 

创建 新 的 Windows 通用 应 用 程序 项 目 时 ， 首 先 会 注意 到 ， 在 设计 问 中 最 示 的 页 面 看 起 来 很 小 。 这 是 因为 这 
4 LH SA TERI 73 13.5 英寸 Surface Book 显示 屏 优化 过 的 视图 。 可 以 使 用 如 图 25-2 所 示 的 Device Preview 面板 
改变 这 个 设置 。 还 可 使 用 这 个 面板 将 纵 同 布局 改 为 模 问 。 


13.5" Surface Book (3000 x 2000) 200% scale 


13.5" Surface Book (3000 x 2000) 200% scale 
5" Phone (1920 x 1080) 300% scale 

6" Phone (1920 x 1080) 250% scale 

8" Tablet (1280 x 800) 125% scale 

12" Tablet (2160 x 1440) 150% scale 

13.3" Desktop (1280 x 720) 100% scale 
23" Desktop (1920 x 1080) 100% scale 

42" Xbox (1920 x 1080) 200% scale 

55" Surface Hub (1920 x 1080) 100% scale 
84" Surface Hub (3840 x 2160) 15056 scale 
4" loT Device (569 x 320) 160% scale 

10" loT Device (1024 x 768) 100% scale 
42" loT Device (1920 x 1080) 10076 scale 


27" HoloLens 2D App (1280 x 720) 150% scale 
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行为 良好 的 应 用 程序 能 在 Device Preview 面板 列 出 的 许多 (但 不 是 所 有 ) 窗 体 元 素 中 显示 出 来 .考虑 到 这 个 列 
表 的 范围 是 从 一 个 4 英寸 的 物 联网 (Internet of Things，IoT) 设 备 到 一 个 84 英寸 的 Surface Hub， 这 是 一 个 艰巨 的 
任务 。 $F, Visual Studio 和 通用 Windows 平台 框架 会 提供 帮助 。 从 下 拉 框 中 改变 分 辩 率 (或 屏幕 大 小 ) 时 ，Visual 
Studio 将 调整 应 用 程序 的 大 小 ， 用 户 马上 就 能 看 到 页 面 是 什么 样子 。 此 外 ， 辅 助 应 用 程序 创建 自 适应 设计 的 控 
件 都 包含 在 工具 箱 中 ， 可 以 利用 它们 轻松 创建 易于 变换 的 UL. 

1. 相对 面板 

在 第 14 章 和 第 15 章 中 ， 使 用 Grid 和 StackPanel 控件 创建 了 一 个 UI， 它 能 提供 很 好 的 静态 显示 效果 。 但 
在 这 个 世界 上 ， 必 须 面 对 很 多 显示 屏 尺 寸 ， 所 以 必须 有 革 种 东西 可 以 更 好 地 移动 控件 。 这 就 是 RelativePanel 
控件 。 


注意 : 

本 章 中 的 示例 假定 读者 熟悉 WPF 和 XAML 开发 ， 相 关内 容 已 在 本 书 第 14 章 和 第 15 章 中 讨论 过 。 

相对 面板 允许 指定 一 个 控件 应 该 如 何 相 对 于 另 一 个 控件 来 定位 。 可 以 把 控件 相 放 在 其 他 控件 的 左边 、 右边 、 
上 边 或 下 边 ， 也 可 以 完成 其 他 一 些 很 好 的 处 理 。 可 以 相对 于 一 个 控件 的 左 、 右 或 中 心 来 水 平和 垂直 放置 另 一 个 
空 件 ， 使 控件 的 边缘 与 面板 的 边缘 对 齐 。 这 意味 着 不 再 需要 利用 像素 让 两 个 控件 在 显示 屏 上 完美 对 齐 。 

2. 上 自 适 应 触发 着 

自 适应 触发 器 是 Visual State Manager 的 新 增 功能 。 使 用 这 些 触发 器 可 以 基于 显示 屏 的 大 小 更 改 应 用 程序 的 
布局 。 与 相对 面板 一 起 使 用 时 ， 这 是 一 个 非常 强大 的 功能 ， 可 以 用 相当 简单 的 方式 构建 网 络 世 界 所 谓 的 啊 应 性 
UL Microsoft 称 之 为 自 适 应 显示 。 在 下 面 的 示例 中 ， 将 使 用 RelativePanel 创建 一 个 可 根据 窗口 的 大 小 来 调整 其 
布局 的 显示 屏 。 


试 一 试 ” 目 适应 显示 : Ch25Ex01 


(1) 选择 File | New | Project， 展 开 Installed | Visual C£ | Universal Windows， 创 建 一 个 新 的 Windows 通用 应 
用 程序 项 目 。 选 择 Blank App (Universal Windows) 项 目 ， 并 命名 为 AdaptiveDisplay。 在 提示 输入 目标 平台 版 本 和 
最 小 平台 版 本 时 ， 单 击 OK 按钮 使 用 默认 设置 。 

(2) 在 Solution Explorer 中 双击 MainPage.xaml 文件 ， 把 一 个 RelativePanel 控件 添加 到 网 格 中 。 其 边 距 设置 
为 20， 将 HorizontalAlignment iZ AJY Stretch. WRI iC A J Height 和 Width 的 值 ， 就 删除 它们 。 

(3) 在 面板 上 添加 textBlock 和 文本 框 : 


<RelativePanel HorizontalAlignment="Stretch" Margin="20" > 
<TextBlock x:Name-"textBlockFirstName" Text="First name" Margin= 
"HL. 10, 10, 5" /> 
«TextBox x:Name-"textBoxFirstName" Text-"" Width="400" RelativePanel.RightOf- 
"LextBlockFirstName" RelativePanel.AlignVerticalCenterWith-"textBlockFirstName" /> 
</RelativePanel> 


(4) 在 网 格 上 添加 一 个 Visual State Manager. 1X(RH, ALN eI — T PCR e 


<VisualStateManager.VisualStateGroups> 
<VisualStateGroup> 
<VisualState x:Name="narrowView"> 
<VisualState.StateTriggers> 
<AdaptiveTrigger MinWindowWidth="0" /> 
</VisualState.StateTriggers> 
<VisualState.Setters> 
«Setter Target="textBoxFirstName. (RelativePanel.Below)" 
Value-"textBlockFirstName" /> 
«Setter 
Target="textBoxFirstName. (RelativePanel. 
AlignVerticalCenterWith)" 
Value-"" /> 
<Setter 
Target="textBoxFirstName. (RelativePanel.AlignLeftWith)" 
Value-"textBlockFirstName" /> 
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</VisualState.Setters> 

</VisualState> 

<VisualState x:Name="wideView"> 
<VisualState.StateTriggers> 

<AdaptiveTrigger MinWindowWidth="720" /> 

</VisualState.StateTriggers> 

</VisualState> 

</VisualStateGroup> 
«/VisualStateManager.VisualStateGroups-» 


(5) 运行 该 应 用 程序 并 重新 调整 窗口 大 小 。 在 窗口 足够 小 ， 小 于 720 RAIN, Œ TextBlock 的 下 方 就 会 弹出 
文本 框 。 


示例 说 明 

这 个 例子 中 的 Visual State Manager 是 根 网 格 的 第 一 个 子 元 素 , 这 很 重要 , 它 允 许 解 释 器 找到 要 引用 的 控件 。 
如 果 把 它 放 在 另 一 个 位 置 ， 虽 然 不 会 出 错 ， 但 也 不 会 得 到 预期 的 结果 。 

Visual State Manager 使 用 AdaptiveTrigger 和 MinWindow With 属性 来 改变 显示 器 的 行为 : 


<AdaptiveTrigger MinWindowWidth="0" /> 


我 们 定义 了 两 个 状态 ， 如 果 视 图 至 少 0 像素 宽 ， 就 激活 其 中 一 个 ， 如 果 视 图 至 少 7203x375. MBA 
个 。 你 可 能 会 认为 ， 视 图 的 宽度 超过 720 像 系 时 ， 两 个 状态 部 会 激活 ， 但 它 不 是 这 样 工 作 的 。 相 反 ， 在 任何 时 
候 都 只 激活 一 个 状态 ， 并 选择 最 匹配 的 那个 状态 。 所 以 ， 当 视图 是 1024 像素 宽 时 ， 就 仪 选中 wide 状态 。 

在 narrowView 中 ， 设 置 了 三 个 属性 : 


<VisualState.Setters> 
«Setter Target-"textBoxFirstName.(RelativePanel.Below)" 
Value-"textBlockFirstName" /> 

«Setter 

Target-"textBoxFirstName.(RelativePanel. 
AlignVerticalCenterWith)" 

Value-"" /> 

«Setter 
Target-"textBoxFirstName.(RelativePanel.AlignLeftWith)" 
Value-"textBlockFirstName" /> 


首先 ， 硝 傈 文本 框 移 到 TextBlock 的 下 面 。 其 次 ， 清 除 AlignVerticalCenterWith 属性 。 如 果 不 改 变 它 ， 将 盏 
决 把 控件 移 到 TextBlock 下 面 的 指令 。 这 是 因为 AlignVerticalCenterWith 属性 直接 在 控件 上 设置 , 如 果 不 清除 它 ， 
它 将 优先 于 View State 的 Below 指令 。 男 一 种 方法 是 避免 直接 在 控件 上 设置 的 任何 属性 ， 只 使 用 视图 状态 。 最 
后 ， 对 齐 控 件 的 左边 绿 。 

wideView 状态 实际 上 是 空 的 。 这 意味 着 不 应 修改 直接 在 控件 上 定义 的 属性 ， 而 应 使 其 处 于 默认 状态 。 


注意 : 

当前 版 本 的 Visual Studio 有 时 无 法 基于 Device Preview 面板 上 的 选择 来 移动 控件 ， 所 以 只 有 运行 应 用 程序 
才能 看 到 结果 。 

3. FlipView 

FlipView 是 个 不 错 的 小 控件 ， 非 常 适合 于 手持 设备 。 它 允许 用 户 向 左 或 向 右 滑动 屏幕 ， 来 显示 一 些 内 容 。 
它 通 常用 于 一 次 显示 一 张 图 像 ， 人 允许 用 户 使 用 滑动 手势 在 图 像 之 间 移 动 。 

默认 情况 下 ，FlipView 允许 用 户 同 左 或 同 右 移动 视图 中 的 内 容 ， 但 也 可 以 改 为 同上 或 同 下 移动 。 使 用 鼠标 
时 ， 滚 动 按钮 也 有 效 。 下 面 的 示例 演示 了 如 何 使 用 FlipView 在 本 地 设备 上 显示 Pictures 文件 夹 的 内 容 。 


试 一 试 ”FlipView: Ch25Ex02 


(1) 选择 File | New | Project ， 展 开 Installed | Visual C# | Universal Windows， 创 建 一 个 新 的 Windows 通用 
应 用 项 目 ， 选 择 Blank App (Universal Windows) 项 目 ， 并 命名 为 PictureViewer. 
(2) 把 Grid 选项 卡 中 的 三 个 RelativePanel 控件 添加 到 MainPage 上 。 


<RelativePanel Margin="20"> 
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<RelativePanel x:Name-"LeftPanel" Margin="0,10,0,0" > 
</RelativePanel> 
<RelativePanel x:Name-"RightPanel" Margin="20,10,0,0"> 
</RelativePanel> 

</RelativePanel> 


(3) 把 一 个 FlipView 添加 到 LeftPanel 面板 上 ， 如 下 所 示 : 


«FlipView x:Name-"flipView" VerticalAlignment="Stretch" 
HorizontalAlignment-"Stretch" > 
«FlipView.ItemTemplate- 


<DataTemplate> 
«Image x:Name-"image" Source="{Binding}" Stretch="Uniform"/> 
</DataTemplate> 
«/FlipView.ItemTemplate- 
</FlipView> 


(4) 把 3 ^^ TextBlock 添加 到 RightPanel 面板 上 ， 如 下 所 示 : 


<TextBlock x:Name="textBlockCurrentImageDisplayName" 
Margin="10,10,10,0" FontSize="24" FontWeight-"Bold" 
RelativePanel.AlignLeftWithPanel-"True" 
RelativePanel.AlignRightWithPanel-"True" /> 

<TextBlock x:Name-"textBlockCurrentImageImageHeight" Margin-"10,10,10,0" 
FontSize-"24" FontWeight-"Bold" 
RelativePanel.AlignLeftWithPanel-"True" 
RelativePanel.AlignRightWithPanel-"True" 
RelativePanel.Below-"textBlockCurrentImageDisplayName" /> 

<TextBlock x:Name-"textBlockCurrentImageImageWidth" Margin-"10,10,10,0" 
FontSize-"24" FontWeight-"Bold" 
RelativePanel.AlignLeftWithPanel-"True" 
RelativePanel.AlignRightWithPanel-"True" 
RelativePanel.Below-"textBlockCurrentImageImageHeight" /> 


(5) 给 控件 添加 以 下 Visual State Manager， 在 应 用 程序 调整 大 小 时 控制 其 外 观 。 把 它 添加 为 Gnd 标记 的 第 
一 个 于 元 系 : 


<VisualStateManager.VisualStateGroups> 
<VisualStateGroup> 
«VisualState x:Name-"narrowView"- 

<VisualState.StateTriggers> 
«AdaptiveTrigger MinWindowWidth="0" /> 

</VisualState.StateTriggers> 

<VisualState.Setters> 
«Setter Target="RightPanel. (RelativePanel.Below)" Value-"LeftPanel" /> 
«Setter Target="RightPanel. (RelativePanel.AlignLeftWithPanel)" Value- 


"True" /> 

«Setter Target="RightPanel. (RelativePanel.AlignRightWithPanel)" Value- 
"True" /> 

«Setter Target-"RightPanel.Margin" Value-"0,10,0,0" /> 

«Setter Target-"LeftPanel.(RelativePanel.AlignTopWithPanel)" Value= 
"True" /> 

«Setter Target-"LeftPanel.(RelativePanel.AlignLeftWithPanel)" Value= 
"Irue" /> 

«Setter Target-"LeftPanel.(RelativePanel.AlignRightWithPanel)" Value- 
"True" /> 


«Setter Target-"LeftPanel.Height" Value-"560" /> 
</VisualState.Setters> 
</VisualState> 
«VisualState x:Name-"wideView"- 
<VisualState.StateTriggers> 
<AdaptiveTrigger MinWindowWidth="720" /> 
</VisualState.StateTriggers> 
<VisualState.Setters> 
<Setter Target="RightPanel. (RelativePanel.AlignBottomWithPanel)" Value= 


"True" /> 

«Setter Target-"RightPanel. (RelativePanel.AlignRightWithPanel)" Value- 
"True" /> 

«Setter Target="RightPanel. (RelativePanel.AlignTopWithPanel)" value= 
"True" /> 

«Setter Target-"RightPanel.Width" Value-"200" /> 

«Setter Target-"LeftPanel.(RelativePanel.LeftOf)" Value-"RightPanel" /> 

«Setter Target-"LeftPanel.(RelativePanel.AlignBottomWithPanel)" Value- 
"True" /> 

«Setter Target-"LeftPanel.(RelativePanel.AlignTopWithPanel)" Value- 
"True" /> 


«Setter Target-"LeftPanel.(RelativePanel.AlignLeftWithPanel)" Value- 
n" True " / > 
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</VisualState.Setters> 
</VisualState> 
</VisualStateGroup> 
«/VisualStateManager.VisualStateGroups- 


(6) 创建 一 个 新 的 类 ， 命 名 为 ImageProperties。 添 加 三 个 属性 ， 如 下 所 示 : 


namespace PictureViewer 
{ 
class ImageProperties 
{ 
public string FileName { get; set; } 
public int Width { get; set; } 
public int Height { get; set; } 
} 
} 


(7) HAERE Shows, AIG P using i85): 


using System; 

using System.Collections.Generic; 
using Windows.Storage; 

using Windows.UI.Xaml; 

using Windows .UI.Xaml.Controls; 
using Windows .Storage.Search; 

using Windows.UI.Xaml.Media.Imaging; 
using Windows.UI.Popups; 

using System.Linq; 


(8) 创建 一 个 私有 字段 ， 来 保存 所 要 显示 图 片 的 一 些 信息 : 


private IList<ImageProperties> imageProperties = new List<ImageProperties>(); 


(9) 添加 一 个 方法 ， 来 加 载 文件 : 


private async void GetFiles() 
{ 
try 
i 
StorageFolder picturesFolder = KnownFolders.PicturesLibrary; 
TReadonlyList<StorageFile> sortedItems = await picturesFolder. 
GetFilesAsync (CommonFileQuery.OrderByDate) ; 
var images = new List<BitmapImage>(); 
if (sortedItems.Any()) 
{ 
foreach (StorageFile file in sortedItems) 
{ 
if (file.FileType.ToUpper() == ".JPG") 
{ 


using (Windows.Storage.Streams.IRandomAccessStream fileStream = await 


file.OpenAsync (FileAccessMode. Read) ) 
{ 
BitmapImage bitmapImage = new BitmapImage (); 
await bitmapImage.SetSourceAsync (fileStream); 
images .Add (bitmapImage) ; 
imageProperties.Add(new ImageProperties 
{ 
FileName = file.DisplayName, 
Height = bitmapImage.PixelHeight, 
Width = bitmapImage.PixelWidth 
p; 
if (imageProperties.Count > 10) 
break; 
} 
} 
} 
} 
else 
{ 
var message = new MessageDialog("There are no images in the Pictures 
Library"); 
await message.ShowAsync (); 
} 
flipView.ItemsSource = images; 
} 
catch (UnauthorizedAccessException) 
{ 
var message = new MessageDialog("The app does not have access to the 
Pictures Library on this device."); 
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await message.ShowAsync (); 
} 
} 


(10) 在 主页 面 的 XAML 中 选择 Page 标记 ， 添 加 Loading 事件 。 然 后 实现 这 个 事件 的 处 理 程序 : 
private void Page Loaded(object sender, RoutedEventArgs e) 


GetFiles(); 
] 


(11) 在 主页 面 的 XAML 中 选择 FlipView, 3:34 SelectionChanged 事件 : 


private void flipView SelectionChanged(object sender, 
SelectionChangedEventArgs e) 


if (flipView.SelectedIndex »- 0) 
{ 
textBlockCurrentImageDisplayName.Text = imageProperties[flipView. 
SelectedIndex].FileName; 
textBlockCurrentImageImageHeight.Text = imageProperties[flipView. 
SelectedIndex].Height.ToString(); 
textBlockCurrentImageImageWidth.Text = imageProperties[flipView. 
SelectedIndex].Width.ToString(); 
} 
} 


(12) 最 后 双击 Package.appxmanifest X fF, 4] Fin £X fr a. 

(13) 选择 Capabilities 选项 卡 ， 确 保 选 中 Pictures Library 功能 。 

(14) 运行 该 应 用 程序 。 

示例 说 明 

代码 使 用 三 个 RelativePanel 来 移动 它 的 内 容 。 所 有 面板 都 没有 直接 的 定位 指令 ,整个 布局 都 是 在 Visual State 
Manager 中 定义 的 。 本 例 使 用 了 两 个 自 适 应 触发 器 ， 如 果 视 图 宽 于 720 像素 ， 就 激活 一 个 自 适 应 触发 器 ， 如 果 
MAT 0 像素 ， 就 激活 另 一 个 目 适 应 触发 器 。 

FlipView 的 代码 在 本 例 中 最 少 。 


<FlipView x:Name="flipView" VerticalAlignment="Stretch" 
HorizontalAlignment="Stretch" > 
«FlipView.ItemTemplate- 
<DataTemplate> 
«Image x:Name-"image" Source="{Binding}" Stretch="Uniform"/> 
</DataTemplate> 
</FlipView.ItemTemplate> 
</FLiIpView> 


这 段 代 码 告 诉 FlipView， 应 该 使 用 这 里 定义 的 ItemTemplate， 它 只 包括 一 个 Image 控件 。 很 明显 ， 可 以 使 
用 FlipView 显示 任何 内 容 ， 而 不 仅仅 是 图 片 。 

Getfiles 方法 中 的 代码 演示 了 几 个 接口 ,它们 可 以 用 于 访问 应 用 程序 中 的 文件 和 资源 。 本 章 后 面 将 讨论 沙 箱 
应 用 程序 的 概念 ， 以 及 它们 对 代码 的 限制 ， 不 过 本 例 已 经 展示 了 这 个 概念 的 一 些 方面 。 如 果 应 用 程序 有 权 访 
问 StorageFolder X} R, bI T Rd NL3kf UE. 1803 Unauthorized AccessException 5t © 

StorageFolder picturesFolder = KnownFolders.PicturesLibrary; 

在 正常 .NET Framework 中 ， 没 有 这 个 类 ， 要 根据 用 户 在 文件 系统 中 的 权限 ， 来 确定 是 个 授予 访问 权限 。 对 
于 应 用 程序 来 说 ， 这 是 非常 不 同 的 。 这 里 必须 事先 声明 应 用 程序 需要 访问 哪些 资源 , 用 户 只 有 接受 了 这 些 权限 ， 
应 用 程序 才能 运行 。 在 步骤 (13) 中 ， 声 明 应 用 将 包括 访问 照片 库 的 能 力 。 如 果 不 这样 做 ， 运 行 应 用 程序 时 会 出 
BUT o 

接 下 来 使 用 StorageFolder 的 GetFilesAsyne 方法 检索 文件 ， 并 按 日 期 排列 。 

一 旦 有 了 文件 ， 就 调用 StorageFile 对 象 上 的 OpenAsync， 打 开 它 们 。 


using (Windows.Storage.Streams.IRandomAccessStream fileStream = await file. 
OpenAsync (FileAccessMode.Read) ) 


返回 一 个 文件 流 ， 可 以 用 它 访 问 文 件 的 内 容 。 本 例 不 希望 写 入 内 容 ， 所 以 只 指定 了 Read 访问 。 
最 后 ， 把 FlipView 的 ItemsSource 设置 为 从 图 片 库 中 加 载 的 图 片 列表 。 
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25.4.2 沙 箱 应 用 程序 


现在 应 回 过 头 来 ， 看 看 通用 Windows 平台 的 NET 框架 的 局 限 性 。 运 行 在 移动 设备 的 应 用 程序 对 运行 它们 
的 操作 系统 只 有 有 限 的 访问 权限 ， 这 意味 着 不 能 编写 某 些 类 型 的 应 用 程序 。 如 果 需 要 直接 访问 文件 系统 ， 以 访 
问 Windows 系统 文件 ， 融 必须 编写 经 典 的 Windows 果 面 应 用 程序 。 

利用 C# 编 写 通 用 应 用 程序 时 ， 会 发 现 应 用 程序 引用 的 .NET Framework 成 为 一 个 限制 因素 ， 缺 少 了 和 常见 的 
名 称 空 间 和 类 ， 或 者 可 用 的 方法 比 以 前 更 少 。 如 果 打 开 Visual Studio， 创 建 一 个 新 的 Blank 应 用 程序 ， 然 后 扩 
展 References 节点 ， 将 看 到 该 引用 非常 不 同 于 Windows 桌面 应 用 程序 中 的 引用 。 这 里 有 一 个 对 分 析 器 的 引用 ， 
以 帮助 监控 应 用 程序 的 各 个 方面 ， 有 一 个 对 NET Core for UWP 的 引用 ， 还 有 一 个 对 Universal Windows 的 引 
用 。 你 可 能 会 认为 ， 可 以 简单 地 改变 引用 ， 从 而 使 用 正常 的 NET Framework。 你 可 以 这 么 做 ， 但 当 你 试 着 把 应 
用 程序 发 布 到 Windows Store 时 ， 应 用 程序 会 因为 不 符合 规范 而 被 拒绝 。 

Windows 通用 应 用 程序 的 沙 箱 性 质 ， 以 及 它们 获得 Windows Store 认可 之 前 必须 经 历 的 过 程 ， 意 味 痢 用 户 
应 该 很 少 担心 通过 Store 会 下 载 到 恶意 的 应 用 程序 。 显 然 ， 有 些 人 会 试图 规避 这 一 点 ， 用 户 不 应 该 放松 警惕 ; 
然而 ， 通 过 Windows Store 应 用 把 恶意 程序 放 在 Windows 计算 机 上 ， 要 大 大 难于 通过 正常 方式 来 下 载 和 安装 应 
用 程序 。 

1. 磁盘 访问 

果 面 应 用 程序 差不多 可 以 随意 访问 磁盘 ， 但 有 一 些 例外 。 一 个 这 样 的 例外 是 ， 通 第 茶 止 它们 写 入 Program 
Files 文件 夹 和 其 他 系统 文件 来 。Windows 通用 应 用 程序 只 能 直接 访问 少数 非常 特定 的 磁盘 位 置 。 这 些 位 置 包括 
安 闭 应 用 程序 的 文件 夹 、 与 应 用 程序 相关 的 AppData 文件 夹 以 及 一 些 特殊 文件 来 ， 如 Documents 文件 来。 文件 
和 文件 夹 的 访问 权限 也 移 到 通用 应 用 程序 的 .NET Framework 中 , 确保 开发 人 员 不 会 意外 地 写 入 某 个 被 禁止 的 
位 置 。 

为 允许 用 户 控 制 应 该 在 应 用 程序 中 存储 和 读 取 什么 地 方 的 文件 ，Windows 提供 了 三 个 File Picker 协定 : 
FolderOpenPicker、FileOpenPicker 和 FileSavePicker。 这 些 选 择 嚣 类 可 以 在 应 用 程序 中 用 于 获得 本 地 磁盘 的 安全 
访问 权限 。 

如 前 所 述 ， 也 可 以 使 用 KnownFolders 类 访问 设备 上 的 资源 。 对 于 要 读 写 的 位 置 ， 如 果 只 有 用 户 拥 有 访问 权 
限 ， 应 用 程序 才能 打开 它们 ， 则 应 使 用 KnownFolders 类 。 

2. 串 行 化 、 流 和 异步 编程 

第 14 章 使 用 [Serializable] 特 性 允许 类 的 序列 化 。 通 用 应 用 程序 的 .NET 不 包含 这 个 特性 , 但 可 以 使 用 一 个 类 
似 的 特性 [DataContract]。DataContract 特性 使 用 DataContractSerializer 类 来 序列 化 类 的 内 容 。 为 把 序列 化 的 内 容 
放 在 磁盘 上 或 从 磁盘 上 序列 化 ， 需 要 使 用 一 些 文件 访问 类 型 ， 但 与 正常 .NET 不 同 ， 不 能 直接 创建 它们 。 而 应 
使 用 文件 选择 器 创建 流 对 象 ， 再 用 流 对 象 科 DataContractSerializer 来 保存 、 加 载 文件 。 


注意 : 

可 以 下 载 的 本 章 项 目 包括 一 个 你 可 能 无 法 使 用 的 证 书 文件 ， 但 可 以 自己 生成 它 。 遵 循 以 下 步骤 : 
(1) 打开 项 目 ， 双 击 Package.appxmanifest 文件 。 

(2) 选择 Packaging 选项 卡 。 

(3) 单 击 Choose Certificate. 

(4) 从 Configure Certificate 中 选择 Create test certificate. 

(5) €x OK. 


Milian f 8H) DataContractSerializator， 并 结合 使 用 通过 FileOpenPicker. FileSavePicker 创建 的 流 ， 
来 加 载 和 保存 数据 模型 的 XML 表示 。 
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试 一 试 “ 磁盘 访问 : Ch25Ex03 


(1) 在 Visual Studio 中 选择 Blank App(Universal Windows)， 创 建 一 个 新 项 目 ， 命 名 为 DataSerialization。 
(2) 在 项 目 中 创建 一 个 新 类 ， 命 名 为 AppData。 

(3) 用 [DDataContract] 特 性 标记 类 ， 把 System.Runtime.Serialization 名 称 空 间 洪 加 a 到 using 部 分 : 

using System.Runtime.Serialization; 


namespace DataSerialization 


{ 
[DataContract] 
class AppData 


} 
} 
(4) 给 类 添加 一 个 int 类 型 的 属性 ， 用 [DataMember] 特 性 标记 它 : 
[DataMember ] 


public int TheAnswer { get; set; } 
(5) 给 项 目 添加 一 个 新 的 枚 举 AppStates. Hi [DataContract] tr lE Eri E: 


using System.Runtime.Serialization; 
namespace DataSerialization 
{ 
[DataContract] 
public enum AppStates 
{ 
} 
} 


(6) 给 AppStates 添加 三 个 值 ， 用 [EnumMember] 特 性 分 别 进行 标记 : 
[EnumMember ] 
Started, 
[EnumMember ] 
Suspended, 


[EnumMember] 
Closing 


(7) 给 AppData KIIPA Tir 88 TE: 


[DataMember] 
public AppStates State [ get; set; ] 
[DataMember] 
public object StateData { get; set; } 


(8) 添加 一 个 新 类 AppStateData， 用 [DataContract] 特 性 标记 它 : 


using System.Runtime.Serialization; 
namespace DataSerialization 


[DataContract] 
public class AppStateData 


[DataMember ] 
public string Data { get; set; } 
} 
} 


(9) 给 AppData 类 添加 [KnownType] 特 性 ， 如 下 : 


[DataContract] 
[KnownType (typeof (AppStateData))] 
public class AppData 

{ 


(10) 在 Solution Explorer 中 双击 MainPage xaml 文件 ， 把 两 个 按钮 拖 到 页 面 中 。 将 其 内 容 和 名称 属 性 设置 
为 Save 和 Load. 

(11) 为 Save 按钮 创建 一 个 单 击 事件 处 理 程序 ， 在 代码 隐 茂 文件 中 导航 到 它 。 添 加 如 下 代码 (注意 方法 声明 
中 的 asyne 关键 字 ): 


private async void Save Click(object sender, RoutedEventArgs e) 


var data = new AppData 
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{ 
State = AppStates.Started, 
TheAnswer = 42, 
StateData = new AppStateData { Data = "The data is being saved" } 
H 
var fileSavePicker = new FileSavePicker 
{ 
SuggestedStartLocation = PickerLocationId.DocumentsLibrary, 
DefaultFileExtension = ".xml", 
Hs 
fileSavePicker.FileTypeChoices.Add("XML file", new[] { ".xml" }); 
var file = await fileSavePicker.PickSaveFileAsync(); 
if (file != null) 
{ 
var stream = await file.OpenStreamForWriteAsync (); 
var serializer = new DataContractSerializer (typeof (AppData) ); 
serializer.WriteObject (stream, data); 
} 
} 


4 ^ m : | = i 一 ^ 1 ^ I* T1 -= h es r | kF = 
(12) 创建 Load ZH] ERFARE ET MSO RERE async 关键 字 ): 
private async void Load Click (object sender, RoutedEventArgs e) 

| 
var fileOpenPicker - new FileOpenPicker 
1 
SuggestedStartLocation - PickerLocationId.DocumentsLibrary, 
ViewMode - PickerViewMode.Thumbnail 
Iz 
fileOpenPicker.FileTypeFilter.Add(".xml"); 
var file = await fileOpenPicker.PickSingleFileAsync(); 
if (file != null) 
{ 
var stream = await file.OpenStreamForReadAsync(); 
var serializer = new DataContractSerializer (typeof (AppData)); 
var data = serializer.ReadObject (stream); 
} 
} 


(13) 需要 把 下 面 两 个 名 称 空间 添加 到 代码 隐藏 文件 中 ; 


using System.Runtime.Serialization; 
using Windows.Storage.Pickers; 


(14) 运行 该 应 用 程序 。 


示例 说 明 


在 步骤 (1) 至 步 又 (9) 中 ,创建 了 应 用 程序 的 数据 模型 。 所 有 类 和 枚 举 都 用 [DataContract] 特 性 标记 ,但 注意 成 
员 的 标记 方式 之 间 的 区 别 。 类 中 的 属性 和 字段 可 用 [DataMember] 特 性 标记 , 但 枚 举 的 成 员 必 须 用 [EnumMember] 


特性 标记 : 


[DataContract | 
public class AppStateData 
{ 

[DataMember] 

public string Data { get; set; } 
} 
[DataContract] 
public enum AppStates 
{ 

[EnumMember ] 

Started, 

[EnumMember | 

Suspended, 

[EnumMember | 

Closing 


} 
这 里 没有 显示 的 男 一 个 特性 CollectionDataContract 比较 有 趣 。 它 可 以 在 自 定 义 集合 上 设置 。 


还 添加 了 一 个 市 有 type 对 象 的 属性 。 为 了 使 序列 化 占 能 够 序列 化 这 个 属性 , 必须 告诉 它 是 什么 类 型 。 Alt, 


可 以 在 包含 该 属性 的 类 上 设置 [KnownTypes] 特 性 。 
Save 和 Load 方法 展示 了 一 些 新 的 文件 选择 器 。 显 示 选 择 器 后 ， 束 返回 一 个 StorageFile 实例 : 
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var file = await fileOpenPicker.PickSingleFileAsync (); 
if (file != null) 


{ 
var stream = await file.OpenStreamForReadAsync(); 
var serializer = new DataContractSerializer (typeof (AppData) ); 
var data = serializer.ReadObject (stream); 
} 
可 以 用 这 个 对 象 打开 一 个 流 ， 用 于 读 写 操作 。 这 里 没有 和 直接 显示 ， 但 也 可 将 它 直 接 用 于 FileIO 25, Ehet 
了 一 些 简单 的 方法 ， 来 写 入 和 读 取 数据 。 


254.3 ”在 页 面 之 间 导 般 


应 用 程序 内 部 页 面 之 间 的 导航 类 似 于 Web 应 用 程序 的 导航 方式 。 可 以 调用 Navigate 方法 从 一 个 页 面 导 航 到 
A Wi, H Back 方法 可 以 返回 。 下 面 的 示例 演示 了 如 何 使 用 三 种 基本 页 面 在 应 用 程序 的 页 面 之 间 移 动 。 


试 一 试 ”导航 : Ch25Ex04 


(1) 在 Visual Studio 中 选择 Blank App(Universal Windows)， 创 建 一 个 新 项 目 ， 命 名 为 BasicNavigation 。 
(2) 选择 并 删除 MainPage.xaml 文件 。 

(3) 右 击 该 项 目 ， 然 后 选择 Add | New item。 使 用 Blank Page 模板 添加 一 个 新 页 面 ， 命 名 为 BlankPage1。 
(4) 重复 步骤 (3) 两 次 ， 项 目 束 有 了 三 个 页 面 ， 分 别 命 名 为 BlankPage2 和 BlankPage3. 


(5) 打开 App-xaml.cs 代码 隐藏 文件 ， 定 位 OnLaunched 方法 。 该 方法 使 用 刚才 删除 的 MainPage， 所 以 把 引 
用 改 为 BlankPagel . 


(6) 在 BlankPagel 上 ， 给 网 格 插入 一 个 堆栈 面板 、 一 个 TextBlock 和 三 个 按钮 : 


<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}"> 
«TextBlock x:Name-"textBlockCaption" Text="Page 1" HorizontalAlignment-"Center" 
Margin-"10" VerticalAlignment="Top"/> 

<StackPanel Orientation-"Horizontal" Grid.Row="1" HorizontalAlignment-"Center"- 
«Button Content-"Page 2" Click="buttonGoto2 Click" /> 
«Button Content-"Page 3" Click-"buttonGoto3 Click" /> 
«Button Content-"Back" Click-"buttonGoBack Click" /» 

</StackPanel> i 

«/Grid» 


(7) 添加 单 击 事件 的 事件 处 理 程 序 ， 如 下 : 
private void buttonGoto2 Click(object sender, RoutedEventArgs e) 


{ 
Frame .Navigate (typeof (BlankPage2)); 


} 
private void buttonGoto3 Click (object sender, RoutedEventArgs e) 
{ 

Frame.Navigate (typeof (BlankPage3)); 
} 
private void buttonGoBack Click(object sender, RoutedEventArgs e) 
{ 


if (Frame.CanGoBack) this.Frame.GoBack(); 
] 


(8) 打开 第 二 页 (BlankPage2)， 添 加 一 个 类 似 的 堆栈 面板 : 


<TextBlock x:Name-"textBlockCaption" Text-"Page 2" HorizontalAlignment-"Center" 
Margin-"10" VerticalAlignment="Top"/> 
<StackPanel Orientation-"Horizontal" Grid.Row="1" HorizontalAlignment-"Center"- 
«Button Content-"Page 1" Click-"buttonGotol Click" /> 
«Button Content-"Page 3" Click-"buttonGoto3 Click" /> 
«Button Content="Back" Click-"buttonGoBack Click" {> 
</StackPanel> 


(9) 把 导航 添加 到 事件 处 理 程序 中 : 
private void buttonGotol Click(object sender, RoutedEventArgs e) 


{ 
Frame .Navigate (typeof (BlankPagel)); 
} 


private void buttonGoto3 Click (object sender, RoutedEventArgs e) 
i 
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Frame .Navigate (typeof (BlankPage3) ); 
} 
private void buttonGoBack Click(object sender, RoutedEventArgs e) 
{ 

if (Frame.CanGoBack) this.Frame.GoBack (); 


} 
(10) 1]1JF58 — 94, 287073 — MERK, H REAA Home 按钮 : 
«TextBlock x:Name-"textBlockCaption" Text-"Page 3" HorizontalAlignment-"Center" 
Margin-"10" VerticalAlignment="Top"/> 
«StackPanel Orientation-"Horizontal" Grid.Row="1" HorizontalAlignment-"Center"- 
«Button Content-"Page 1" Click-"buttonGotol Click" /> 
«Button Content-"Page 2" Click-"buttonGoto2 Click" /» 


«Button Content-"Back" Click-"buttonGoBack Click" /> 
«/StackPanel» 


(11) 添加 事件 处 理 程序 ; 


private void buttonGotol Click(object sender, RoutedEventArgs e) 
i Frame .Navigate (typeof (BlankPagel)); 
—— void buttonGoto2 Click(object sender, RoutedEventArgs e) 
Frame .Navigate (typeof (BlankPage2) ); 
—— void buttonGoBack Click(object sender, RoutedEventArgs e) 


{ 
if (Frame.CanGoBack) this.Frame.GoBack(); 


} 
(12) 运行 应 用 程序 。 该 应 用 程序 显示 有 三 个 按钮 的 首页 。 


示例 说 明 
运行 应 用 程序 时 ， 它 显示 了 一 个 加 载 时 的 闪 屏 ， 接 着 显示 第 一 个 页 面 。 第 一 次 单 击 一 个 按钮 时 ， 使 用 想 浏 
时 的 页 和 面 类 型 调用 Navigate 方法 : 


Frame.Navigate (typeof (BlankPage2)); 


它 没 有 显示 在 这 个 例子 中 ， 但 Navigate 方法 包括 一 个 重 载 厂 本 ， 人 允许 把 参数 友 送 给 要 导航 到 的 页 面 上 。 在 
页 面 之 间 导 航 时 ， 请 注意 ， 如 条 使 用 一 个 按钮 返回 第 一 页 ，Back 按钮 仍然 是 活动 的 。 

在 每 个 页 面 上 ， 使 用 GoBack 事件 的 实现 代码 回 到 上 一 页 。 调 用 GoBack 方法 之 有 前 ， 会 检查 CanGoBack /& 
性 。 人 否则 ， 在 显示 的 第 一 页 上 调用 GoBack 时 ， 会 得 到 一 个 异 第 。 


if (Frame.CanGoBack) this.Frame.GoBack(); 


每 次 导航 到 一 个 页 面 ， 孝 会 创建 一 个 新 实例 。 为 了 改变 这 一 行为 ， 可 以 在 页 面 的 构造 函数 中 局 用 属性 
NavigationCacheMode， 例 : 

public BasicPagel () 

this.InitializeComponent () ; 


NavigationCacheMode = Windows.UI.Xaml.Navigation.NavigationCacheMode.Enabled; 
} 


会 缓 仔 页 面 。 
25.44 CommandBar 控件 


CommandBar 为 用 户 提供 的 功能 与 果 面 应 用 程序 的 工具 栏 基本 相同 ， 但 应 该 让 它们 简单 得 多 ， 通 第 限制 工 
具 栏 上 可 用 的 选项 少 于 8 项 。 
一 次 可 以 显示 多 个 CommandBar， 但 请 记 住 ， 这 会 使 用 户 界 面 很 江 乱 ， 不 应 该 只 为 显示 更 多 选项 而 显 
多 个 工具 栏 。 另 一 方面 ， 如 果 想 提供 多 种 导航 ， 有 时 同时 把 工具 栏 显示 在 项 部 和 展 部 会 比较 好 。 
Visual Studio iffi Y CommandBar 控件 ， 很 容易 创建 这 种 类 型 的 控件 。 下 面 的 示例 创建 一 个 应 用 程序 的 工 
具 栏 ， 其 中 包含 许多 标准 项 。 
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试 一 试 ” 创 建 CommandBar: Ch25Ex05 


(1) 回 到 先前 的 BasicNavigation 示例 。 
— A CY Wt J EN A rz dx yc mpm = — pe -F — cE 
(2) 在 三 个 页 面 上 都 添加 一 个 CommandBar。 把 它 作 为 每 个 页 和 面 上 Grid 控件 的 子 元 素 : 
<CommandBar> 
«AppBarToggleButton x:Name-"toggleButtonBold" Icon-"Bold" Label="Bold" Click= 
"AppBarToggleButtonBold Click" /> 
«AppBarSeparator /» 
«AppBarButton Icon-"Back" Label-"Back" Click-"buttonGoBack Click"/> 
«AppBarButton Icon-"Forward" Label-"Forward" Click- 
"AppBarButtonForward Click"/> 
«CommandBar.SecondaryCommands- 
«AppBarButton Icon-"Camera" Label-"Take picture" /> 
«AppBarButton Icon-"Help" Label-"Help" /> 
</CommandBar .SecondaryCommands> 
</CommandBar> 
(3) 把 下 面 的 事件 处 理 程 序 添 加 到 所 有 三 个 页 面 上 : 
private void AppBarButtonForward Click(object sender, RoutedEventArgs e) 
{ 
if (Frame.CanGoForward) this.Frame.GoForward(); 
} 
private void AppBarToggleButtonBold Click(object sender, RoutedEventArgs e) 
{ 
AppBarToggleButton toggleButton = sender as AppBarToggleButton; 
bool isChecked = toggleButton.IsChecked.HasValue ? 
(bool)toggleButton?.IsChecked.Value : false; 
textBlockCaption.FontWeight = isChecked ? FontWeights.Bold : 
FontWeights.Normal; 
} 


(4) 把 下 面 的 using 语句 添加 到 所 有 页 面 上 : 
using Windows.UI.Text; 


(5) 在 所 有 三 个 页 面 上 ， 把 文本 框 的 margin 改 为 10,50,10,10。 
(6) 运行 该 应 用 程序 。 


示例 说 明 

运行 这 个 应 用 程序 时 ， 现 在 可 以 使 用 命令 栏 按钮 在 曾经 访问 过 的 页 面 列 表 中 来 回 移动 。 命 令 栏 本 身 很 容易 
处 理 。 

命令 栏 用 三 种 类 型 来 建立 。 第 一 个 是 AppBarToggleButton. 


«AppBarToggleButton x:Name-"toggleButtonBold" Icon-"Bold" Label-"Bold" Click= 
"AppBarToggleButtonBold Click" /> 


这 种 类 型 的 按钮 可 用 来 显示 开局 或 关闭 的 状态 。 
第 二 种 类 型 是 AppBarButton， 与 任何 其 他 按钮 类 似 , 事实 上 可 以 看 到 ，AppBarButtonBack 按钮 的 单 击 事件 
是 由 前 面 示例 中 ButtonBack 的 同一 个 事件 处 理 程序 处 理 的 。 


<AppBarButton Icon="Back" Label="Back" Click="buttonGoBack Click"/> 


用 于 命令 栏 的 第 三 中 类 型 是 AppBarSeperator。 这 种 控件 只 显示 命令 栏 中 的 分 隔 线 。 
最 后 ， 两 个 按钮 位 于 CommandBar.SecondaryCommands 标签 内 : 
<CommandBar .SecondaryCommands> 
<AppBarButton Icon-"Camera" Label="Take picture" /> 
<AppBarButton Icon-"Help" Label-"Help" /> 


</CommandBar .SecondaryCommands> 
</CommandBar> 
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25.4.5 ”管理 状态 


与 桌面 应 用 程序 不 同 ， 应 用 程序 必须 能 随时 暂停 。 在 用 户 切换 到 另 一 个 应 用 程序 或 桌面 时 ， 就 会 发 生 这 种 
情况 。 所 以 它 必须 是 一 个 由 所 有 应 用 程序 处 理 的 常见 场景 。 当 应 用 程序 暂停 时 ，Windows 将 保存 变量 的 值 和 数 
据 结构 ， 并 在 应 用 程序 恢复 执行 时 恢复 它们 。 然 而 ， 应 用 程序 可 能 已 经 暂停 了 较 长 时 间 ， 所 以 如 果 数 据 (如 新 闻 
摘要 ) 随 着 时 间 的 推移 而 变化 ， 就 应 该 在 应 用 程序 恢复 执行 时 更 新 它 。 

暂停 应 用 程序 时 ， 还 应 该 考虑 调用 应 用 程序 之 间 应 保存 的 任何 数据 ,如 果 应 用 程序 随后 由 Windows 或 用 户 
终止 了 ， 就 没有 机 会 这 样 做 。 

应 用 程序 要 暂停 时 , 会 发 送 Suspending 事件 , 应 该 处 理 该 事件 。 当 应 用 程序 恢复 执行 时 , 它 将 接收 Resuming 
事件 。 处 理 这 两 个 事件 ， 保 存 应 用 程序 的 状态 ， 就 可 以 把 应 用 程序 返回 到 暂停 之 前 的 状态 ， 且 用 户 不 会 注意 到 
什么 。 


试 一 试 ” 从 暂 俘 中 恢复 : Ch25Ex06 


(1) 回 到 前 面 的 示例 ， 并 创建 一 个 新 类 AppState: 


using System.Collections.Generic; 
namespace BasicNavigation 
{ 
public static class AppState 
{ 
private static Dictionary<string, bool> state = new Dictionary<string, bool>(); 
public static bool GetState(string pageName) => state.ContainskKey (pageName) ? 
state[pageName] : false; 
public static void SetState(string pageName, bool isBold) 
{ 
if (state.ContainsKey (pageName) ) 
state [pageName] = isBold; 
else 
state.Add(pageName, isBold); 
} 
public static void Save () 
{ 
var settings = Windows.Storage.ApplicationData.Current.RoamingSettings; 
foreach (var key in state.Keys) 


settings .Values[key] = state[key]; 
} 


} 
public static void Load(string pageName) 
{ 
if (!state.ContainsKey (pageName) && Windows.Storage.ApplicationData.Current. 
RoamingSettings.Values.ContainsKey (pageName) ) 
State.Add(pageName, (bool)Windows.Storage.ApplicationData.Current. 
RoamingSettings.Values[pageName]); 


1 
} 


(2) 打开 app.xaml 文件 的 代码 隐藏 文件 ， FEAR ZEW. OnSuspending 方法 。 添 加 AppState.Save0， 如 下 所 示 : 


private void OnSuspending(object sender, SuspendingEventArgs e) 
{ 
var deferral = e.SuspendingOperation.GetDeferral(); 
//TODO: Save application state and stop any background activity 
AppState.Save(); 
deferral.Complete(); 
} 


(3) 在 OnLaunched 方法 的 抵 部 、Window.Current.Activate0: 的 前 面 添加 如 下 代码 : 


AppState. Load (typeof (BlankPagel) .Name) ; 
AppState. Load (typeof (BlankPageZ) .Name) ; 
AppState. Load (typeof (BlankPage3) .Name) ; 


(4) 进入 BlankPagel, fF Page 类 上 添加 loaded 事件 ， 如 下 所 示 : 


<Page 
x:Class-"BasicNavigation.BlankPagel" 
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xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlns:local-"using:BasicNavigation" 
xmlns:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable-"d" Loaded-"Page Loaded" 
private void Page Loaded(object sender, RoutedEventArgs e) 
{ 
toggleButtonBold.IsChecked = AppState.GetState (GetType () .Name); 
AppBarToggleButtonBold Click(toggleButtonBold, new RoutedEventArgs ()); 


(6) 修改 开关 按钮 的 Click 事件 处 理 程 序 ， 在 按 下 按钮 时 保存 页 面 的 状态 : 
private void AppBarToggleButtonBold Click(object sender, RoutedEventArgs e) 


{ 
AppState.SetState(GetType().Name, (bool)toggleButtonBold.IsChecked); 


] 

(7) 对 BlankPage2 和 BlankPage3 重复 步骤 (0) 到 步骤 (6)。 

(8) 在 app.xaml 代 公 隐藏 文件 中 ， 给 OnSuspending 方法 设置 一 个 断 点 。 

(9) 运行 该 应 用 程序 。 

(10) 一 旦 运行 应 用 程序 ， 就 单 击 一 两 个 页 面 上 的 Bold 按钮 。 然 后 ， 应 用 程序 仍 在 运行 ,返回 Visual Studio. 
如 果 设 有 显示 Debug Location 工具 栏 ， 则 在 工具 栏 区域 右 击 并 确保 选中 它 。 单 击 Lifecycle Events 下 拉 框 ， 单 击 
Suspend. 

(11) 一 旦 单 步 执行 OnSuspended 方法 ， 应 用 程序 就 暂停 。 冉 次 展开 下 拉 框 ， 单 击 Resume. 


示例 说 明 

AppState 类 使 用 Windows.Storage.ApplicationData 关 来 保存 应 用 程序 设置 . 这 个 类 允许 访问 应 用 程序 数据 存 
储 ， 轻 松 地 设置 一 些 简 单 的 值 。 应 该 只 在 这 个 库 中 存储 简单 类 型 ， 如 果 需 要 保存 应 用 程序 中 非 弟 复杂 的 状态 ， 
应 该 考虑 其 他 一 些 机 制 ， 如 数据 库 或 XML 文件 。 

应 用 程序 已 经 在 app.xaml 代码 隐 疾 代码 文件 中 处 理 了 了 Suspending 事件 ， 所 以 可 以 简单 地 使 用 它 。 如 果 必 须 
为 某 些 页 面 单独 暂停 事件 ， 也 应 该 在 页 面 本 身 处 理 这 个 事件 。 

在 OnSuspending 事件 中 ， 保 存 了 整个 应 用 程序 的 状态 ， 以 便 在 应 用 程序 重新 局 动 时 可 以 检索 它 。 由 于 在 
应 用 程序 从 暂停 中 恢复 时 ， 任 何 页 面 都 没有 必须 要 更 新 的 数据 ， 所 以 没有 处 理 Resuming 事件 。 

在 OnLaunched 方法 加 载 应 用 程序 时 ， 人 恢复 状态 ，OnLaunched 方法 也 位 于 app.xaml 代码 隐 兰 文件 中 。 


25.5 Windows Store 应 用 程序 的 常见 元 素 


所 有 Windows Store 应 用 程序 部 应 该 提供 日 己 的 磁 贴 和 徽章 。 磁 贴 将 应 用 程序 显示 在 Windows 的 开始 页 面 
上 ， 人 允许 显示 关于 应 用 程序 的 信息 。 徽 章 允 许 Windows 显示 一 个 小 图 像 ， 代 表 Lock Screen 上 的 应 用 程序 。 

磁 贴 很 重要 ， 因 为 用 户 往 往 很 浮躁 ， 倾 辐 于 根据 应 用 程序 外 观 来 做 决策 。 同 时 ， 磁 贴 应 该 易于 状 认 ， 如 果 
让 用 尸 搜索 消失 在 一 个 磁 贴 中 的 男 一 个 位 贴 ， 在 最 终 找到 它 之 前 ， 他 们 不 太 可 能 有 好 心情 。 

在 Windows Store 应 用 程序 中 有 许多 可 能 的 磁 巾 大小， 如 果 应 用 程序 面 癌 许多 不 同 的 显示 屏 矿 寸 ， 束 应 该 
按照 所 有 建议 的 矿 寸 提供 定制 的 磁 贴 ， 或 者 至 少 提供 缩放 得 很 好 的 磁 贴 。 如 果 没 有 提供 正确 大 小 的 磁 贴 ， 
Windows 会 把 所 提供 的 磁 贴 绚 放 到 正确 的 尺寸 ， 但 它 通 党 看 起 来 很 糟 粽 。 因 此 ， 对 于 专业 的 应 用 程序 ， 应 确 你 
磁 贴 的 每 个 尺寸 部 符合 预期 。 

和 例 章 比 磁 贴 小 24X24 (RAR), Windows 显示 应 用 程序 时 在 Lock Screen 上 使 用 。 如 果 为 应 用 程序 设置 了 一 个 
HARF, WEAH Lock Screen 通知 。 徽 章 也 可 以 缩放 ， 所 以 应 提供 所 有 适当 的 矿 寸 。 

应 用 程序 加 载 时 会 显示 闪 屏 ， 因 为 内 屏 应 该 只 显示 很 短 的 时 间 ， 所 以 不 应 该 太 复杂 ， 或 给 用 户 提 供 任何 类 
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型 的 信息 ， 只 需要 清晰 地 表示 应 用 程序 正在 局 动 。 闪 屏 至 少 是 620X300 像素 ， 但 是 可 以 使 部 分 图 像 透 明 ， 让 
办 屏 更 小 。 男 外 ， 应 提供 按 比 例 绚 放 的 版 本 。 

最 后 ， 应 该 提供 一 个 50X50 像素 的 “商店 标志 ”， 当 然 还 应 提供 按 比 例 缩放 的 版本 。 

磁 贴 、 征 章 、 标 志 钳 入 在 应 用 程序 包 清 单 中 , 在 Visual Studio Manifest Package 编辑 器 中 可 以 轻松 地 编辑 它 。 
如 作 已 经 下 载 了 本 书 的 代码 ， 融 可 以 使 用 随 代 码 一 起 提供 的 伐 贴 和 徽章 (在 Assets MPFR), vll n] LAGE Paint 
或 类 似 的 应 用 程序 中 很 快 地 创建 图 像 。 在 下 面 的 示例 中 ， 为 Windows 通用 应 用 程序 添加 了 一 些 磁 贴 、 标 志和 内 
屏 图 像 。 


试 一 试 ”添加 磁 贴 和 徽章 


(1) 使 用 Paint 等 图 像 编 辑 嚣 创建 如 下 尺寸 的 PNG AR: 
620 x 300 
310 X 150 
310 X 310 
150 X 150 
71 X 71 
50 X 50 
44 X 44 
e 24 X 24 
给 图 片 命 名 ， 使 图 片 在 不 打开 的 情况 也 可 以 识别 出 来 。 
(2) 打开 前 面 示例 中 的 项 目 。 
(3) 删除 Assets 文件 夹 中 的 所 有 图 像 。 
(4) 在 Solution Explorer 中 双击 Package.appxmanifest 文件 ， 打 开 包 编辑 器 。 
(5) Œ Visual Assets 标题 下 ， 找 到 左 按 的 荣 单 ， 其 中 的 选项 可 供 改变 磁 贴 、 标 志和 内 屏 。 对 于 这 几 项 ， 单 击 
其 图 像 源 按 钮 ， 选 择 合适 的 图 像 。 之 后 单 击 Generate 按钮 ， 让 Visual Studio 对 图 像 进行 缩放 。 
(6) 选择 Application 标签 ， 选 择 Lock Screen Notifications 下 拉 框 中 的 Badge 选项 。 
(7) 编译 该 应 用 程序 ， 在 Solution Explorer 中 右 击 该 项 目 ， 并 选择 Deploy. 


示例 说 明 

进入 Start 豆单 ,找到 应 用 程序 。 可 能 要 单 击 All Apps 或 搜索 名 字 。 注意 小 磁 贴 显示 在 列表 中 。 如果 右 击 它 ， 
并 把 应 用 程序 固定 到 Start 菜单 中 ， 吏 会 使 用 一 个 更 大 的 磁 贴 。 可 以 右 击 磁 贴 ， 并 选择 Resize， 改 变 其 大 小 。 

当 应 用 程序 运行 时 ， 内 屏 会 很 快 出 现 。 

在 沫 单 中 右 击 应 用 程序 ， 冉 次 选择 Uninstall， 删 除 它 。 


25.6 Windows Store 


创建 应 用 程序 之 后 ， 可 能 想 将 它 分 发 给 公众 ， 方 法 是 使 用 Windows Store. Microsoft 55/3477], 8È f — 
个 安全 的 商店 ， 让 Windows 用 户 从 中 下 载 应 用 程序 ， 不 必 担 心 会 下 载 到 恶意 代码 。 遗 憾 的 是 ， 这 意味 着 把 应 用 
程序 放 在 商店 中 必须 经 历 漫长 的 过 程 。 


25.6.1 打包 应 用 程序 


指定 访问 Pictures Library P zl] Picture Viewer 时 ， 以 及 给 应 用 程序 添加 磁 巾 时， 都 看 到 了 
package.appxmanifest 文件 的 一 些 内 容 。 准 备 打 包 应 用 程序 ， 用 于 App Store 时 ， 必 须 回 到 这 个 文件 ， 设 置 其 他 
许多 值 。 


第 25 章 通用 应 用 程序 | 561 


打包 应 用 程序 之 前 ， 应 该 进入 6 个 选项 卡 中 ， 在 其 中 配置 package.appxmanifest， 考 虑 每 一 个 选项 : 

e Application: 好 好 给 应 用 程序 命名 ! 应 用 程序 名 和 商店 标志 可 能 是 潜在 用 户 看 到 应 用 程序 的 第 一 个 信息 ， 
所 以 给 它 指定 一 般 的 名 称 是 无 效 的 。 试 看 选择 一 个 有 趣 的 名 称 ， 同 时 表明 应 用 程序 的 作用 。 

e Visual Assets: 在 最 后 一 个 示例 中 给 应 用 程序 添加 了 位 贴 ， 应 该 确保 在 Visual Assets 标签 中 ,每 一 类 别 
至 少 有 一 个 图 像 。 

e Capabilities: 在 这 个 选项 卡 上 ， 指 定 应 用 程序 需要 哪些 功能 。 注 意 ， 如 果 应 用 程序 需要 的 功能 不 合理 ， 
用 户 会 把 该 应 用 程序 视 为 可 疑 。 例 如 ， 如 果 需 要 访问 设备 上 的 聊天 信息 ， 最 好 有 一 个 充分 的 理由 ， 人 否 
则 很 可 能 会 被 视 为 潜在 地 侵犯 隐私 。 大 多 数 应 用 程序 都 只 需要 几 个 功能 ， 但 必须 选择 所 有 要 使 用 的 功 
能 。 如 果 没 有 准确 地 指定 需要 的 功能 ， 应 用 程序 试图 访问 资源 时 ， 会 收 到 一 个 拒绝 访问 异 弟 。 

e Declarations: 在 这 个 选项 卡 上 ， 可 以 把 应 用 程序 注册 为 服务 提供 者 。 例 如 ， 如 果 应 用 程序 是 一 个 搜索 
提供 者 ， 就 可 以 将 这 个 声明 添加 到 应 用 程序 中 ， 并 指定 所 需 的 属性 。 

e Content URIs: 如 果 应 用 程序 导航 到 远程 页 面 ， 它 对 系统 的 访问 权限 就 是 有 限制 的 。 可 以 使 用 Content 
URIs 给 Web 页 面 提供 定位 设备 和 剪贴 板 的 访问 权限 。 

e Packaging: 这 个 选项 卡 可 以 设置 包 的 属性 ， 包 括 开 发 者 /出 版 商 的 名 称 、 应 用 程序 的 版 本 、 用 于 签名 包 
的 证 书 。 


25.6.2 ”创建 包 


一 日 在 appxmanifest 中 指定 了 所 有 需要 的 内 容 ， 残 可 以 准备 打包 应 用 程序 了 。 为 此 ， 可 在 Visual Studio 中 
直接 选择 Project | Store | Create App Packages。 这 将 局 动 Create App Packages 回 导 。 在 该 回 导 的 几 步 中 ， 需 要 用 
store 账户 登录 。 如 果 没 有 store 账户 ， 就 必须 创建 一 个 。 必 须 有 一 个 store 账户 ,才能 把 应 用 程序 发 布 到 商店 中 ， 
获得 应 用 程序 的 报酬 。 

在 同 导 中 ， 会 显示 Select and Configure Packages 负面。 在 这 个 页 面 中 ,一 定 要 选择 全 部 三 个 目标 架构 (x86、 
x64 和 ARM)， 应 用 程序 才能 部 普 到 范围 最 广汉 的 设备 上 。 

在 最 终 页 上 ， 要 选择 如 何 确认 应 用 程序 可 以 提交 给 应 用 商店 。 局 动 Windows App Certification Kit， 了 解 应 
用 程序 是 否 已 准备 好 提交 。 如 果 检 测 到 任何 问题 ， 就 必须 更 正 它 们 ， 再 次 司 动 Create App Packages HF. WR 
应 用 程序 通过 检查 ， 就 可 以 上 传 包 。 


25.7 ”习题 


(1) 扩展 Ch25Ex06 例子 ， 给 BlankPagel 页 面 添加 一 个 WebView 控件 ， 使 用 导航 方法 ， 显 示 所 选 的 Web 
页 面 。 给 页 面 添 加 一 个 事件 处 理 程序 ， 在 应 用 程序 从 暂停 中 恢复 时 ， 把 WebView 导航 到 男 一 个 网 页 。 

(2) 如 果 升 望 应 用 程序 用 作 录 音 机 ， 就 必须 确保 该 应 用 程序 可 以 访问 设备 上 的 麦 殉 风 。 当 应 用 程序 试图 使 
用 设备 上 的 考 元 风 时 ， 如 何 确 保 它 不 会 得 到 UnauthorizedAccessException? 

附录 A 给 出 了 习题 答案 。 


258 本章 要 点 


room 要 点 
Windows 通用 应 用 程 | Windows 通用 应 用 程序 XAML 和 C# 一 起 使 用 , 创建 Windows 通用 应 用 程序 的 GUI。 它 包括 许多 与 WPF 
序 XAML 相同 的 控件 ， 但 是 一 些 已 经 发 生 了 变化 ， 其 他 一 些 已 不 存在 ， 并 且 还 引入 了 新 的 控件 


Visual State 管理 器 我 们 学 习 了 如 何 使 用 Visual State 管理 器 ， 只 要 改变 控件 的 可 视 化 状态 ， 就 可 以 改变 控件 和 页 面 的 外 观 。 
这 样 代 码 更 少 ， 但 XAML 略微 复杂 一 些 
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( 续 表 ) 
t we 要 A 
应 用 程序 状态 当 用 户 切 换 到 男 一 个 应 用 或 泉 面 时 ，Windows 通用 应 用 程序 会 暂停 ， 所 以 一 定 要 处 理 这 种 暂停 ， 并 在 暂 
停 时 保存 应 用 程序 的 状态 
App Store 账户 这 个 账户 用 于 把 应 用 程序 部 署 到 Windows Store 上 
导航 在 Windows 通用 应 用 程序 中 导航 的 方式 几乎 与 在 Web 应 用 程序 中 相同 ， 也 使 用 方法 调用 在 页 面 结构 中 


来 回 移动 


附录 


JAER 


1. 2, 18 和 19 章 没 有 习题 。 
第 3 章 


习题 1 


super.smashing.great 


2] 2 
b)， 因 为 它 以 数字 开头 ; e) ANE BATA. 


JA 3 
不 ， 理 论 上 没有 限制 包含 在 string 变量 中 的 字符 串 的 长 度 。 


习题 4 


这 里 ，* 和 /以 及 % 运 算 符 的 优先 级 最 局 ， 其 次 是 +， 最 后 是 。 本 习题 中 的 优先 级 可 以 用 括号 来 演示 ， 如 下 
所 示 : 


resultVar += ((varl * var2) + ((var3 $ var4) / var5)); 


RA 5 


using static System.Console; 

using static System.Convert; 

static void Main(string[] args) 

{ 
int firstNumber, secondNumber, thirdNumber, fourthNumber; 
WriteLine ("Give me a number:"); 
firstNumber = ToInt32 (ReadLine()); 
WriteLine("Give me another number:"); 
secondNumber = ToInt32(Console.ReadLine());:; 
WriteLine("Give me another number:"); 
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thirdNumber = ToInt32 (ReadLine()); 

WriteLine ("Give me another number:"); 

fourthNumber = ToInt32 (ReadLine()); 

WriteLine($"The product of {firstNumber}, {secondNumber}, " + 
$"{thirdNumber}, and (fourthNumber) is " + 
$"(firstNumber * secondNumber * thirdNumber * fourthNumber}."); 


= 


* LN 


注意 这 里 使 用 了 Convert.ToImt320， 本 章 没 有 介绍 它 。 
第 4 章 


JA 1 


a 


(varl > 10) * (var2 > 10) 
习题 2 


注意 ， 至 少 有 一 个 数 必须 大 于 10， 以 便 与 所 和 输入 的 情况 保持 一 致 。 尺 外 ， 在 使 用 ToDoubleO 试 图 转换 所 和 输 
入 的 值 之 前 ， 要 检查 该 值 是 人 否 已 输入 。 


using static System.Console; 
using static System.Convert; 
static void Main(string[] args) 
{ 
bool numbersOK = false; 
double varl, varž; 
varl = 0; 
Var2 = 0; 
while (!numbersoOK) 
{ 
WriteLine ("Enter 2 numbers, both numbers cannot be greater than 10."); 
WriteLine ("Please enter the first number:"); 
varl = ToDouble (ReadLine()); 
WriteLine ("Please enter the second number:"); 
var? = ToDouble (ReadLine()); 


WriteLine($S"The first number entered is {varl} " + 
S"and the second is {var2}"); 


if ((varl > 10) ^ (var2 > 10)) 
{ 
numbersOK = true; 
} 
else if ((var2 > 10) ^ (varl > 10)) 
{ 
numbersOK = true; 
} 
else 
{ 
WriteLine ("Only one number may be greater than 10, " + 
"please try again."); 
} 
} 
WriteLine ("Press the «ENTER» key to exit."); 
ReadLine(); 


} 


习题 3 
代码 如 下 : 


int i: 
for (1 = 1; 1 <= 10; i++) 
{ 
if ((i $ 2) = 0) 
continue; 


WriteLine (i); 
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使 用 赋值 运算 符 = 而 不 是 布尔 运算 符 一 ， 这 是 一 个 十 分 常见 的 错误 。 
第 5 章 


ai 1 
a 和 c 的 转换 不 能 隐 式 进行 。 
ma 2 


enum color : short 


Red, Orange, Yellow, Green, Blue, Indigo, Violet, Black, White 
} 
HLA, byte 类 型 可 以 包含 0—255 之 间 的 数字 。 如 果 枚 举 项 使 用 不 同 值 ， 基 于 byte 的 枚 举 可 以 包含 256 项 ; 
如 果 给 枚 举 项 使 用 重复 的 值 ， 就 可 以 包含 更 多 的 项 。 


JA 3 


无 法 编译 代码 ， 原 因 如 下 : 
e 遗漏 了 语句 末尾 的 分 号 。 
e 第 二 行 尝 试 访问 blab 中 不 存在 的 第 6 个 元 素 。 
e 第 二 行 党 试 指定 未 包含 在 双 引 号 中 的 字符 串 。 


习题 4 


using static System.Console; 
static void Main(string[] args) 
{ 
WriteLine ("Enter a string:"); 
string myString = ReadLine(); 
string reversedString = ""; 
for (int index = myString.Length - 1; index >= 0; index--) 
{ 
reversedstring += myString[index] ; 
} 
WriteLine ($"Reversed: {reversedString}") ; 


ea 5 


using static System.Console; 
static void Main(string[] args) 


{ 
WriteLine ("Enter a string:"); 
string myString = ReadLine() ; 
myString = myString.Replace("no", "yes"); 
WriteLine($"Replaced \"no\" with \"yes\": [myString)"); 
} 


习题 6 


using static System.Console; 
static void Main(string[] args) 


WriteLine ("Enter a string:"); 
string myString = ReadLine(); 
myString = nimm + myString .Replace (" ". nx n Ann) + ninm = 
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WriteLine ($"Added double quotes around words: (myString)"); 
} 


或 者 使 用 String. Split(): 


using static System.Console; 
static void Main(string[] args) 
{ 
WriteLine ("Enter a string:"); 
string myString = ReadLine(); 
string[] myWords = myString.Split(' '); 
WriteLine ("Adding double quotes around words:"); 
foreach (string myWord in myWords) 
i 
Write ($"X n (myWord) X "m n ) = 
} 


? osx 


习题 1 


第 一 个 函数 的 返回 类 型 是 bool， 但 不 返回 一 个 bool 值 。 
第 二 个 函数 有 一 个 params 实 参 ， 但 这 个 实 参 不 在 实 参 列表 的 末尾 处 。 


ea 2 


using static System.Console; 
static void Main(string[] args) 
{ 
if (args.Length != 2) 
{ 
WriteLine ("Two arguments required."); 
return; 
} 
string paraml = args[0]; 
int param2 = ToInt32(args[1]); 
WriteLine ($"String parameter: (paraml)",); 
WriteLine ($"Integer parameter: (param2)",); 
} 


注音 这 个 管 案 包 含 的 代码 检查 是 否 提 供 了 两 个 实 参 ,本题 没 有 这 个 要 求 , 但 在 本 题 中 进 


Pie RH. 
JA 3 


class Program 

{ 
using static System.Console; 
delegate string ReadLineDelegate(); 
Static void Main(string[] args) 


{ 
ReadLineDelegate readLine = new ReadLineDelegate (ReadLine) ; 
WriteLine ("Type a string:"); 
string userInput = readLine(); 
WriteLine($"You typed: (userInput)"); 
} 


习题 4 


struct order 


{ 


A 


T 


TEL 
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public string itemName; 
public int unitCount; 
public double unitCost; 
public double TotalCost() => unitCount * unitCost;)] 


ju 5 


struct order 


{ 
public string itemName; 
public int unitCount; 
public double unitCost; 
public double TotalCost() => unitCount * unitCost; 
public string Info() => "Order information: " + unitCount.ToString() + 
" " + itemName + " items at $" + unitCost.ToString() + 
" each, total cost $" + TotalCost().ToString(); 
} 


第 7 章 


习题 1 


这 个 语句 仅 对 要 用 于 所 有 版 本 的 信息 有 效 。 而 且 ， 我 们 第 彰 布 望 仅 在 使 用 调试 版 本 时 输出 调试 信息 。 此 时 
应 首选 Debug.WriteLineO0 版 本 。 
使 用 Debug.WriteLine0 版 本 还 有 一 个 优点 : 该 版 本 不 会 编译 到 友 布 版 本 中 ， 从 而 使 最 终 代码 文件 变 得 更 小 。 


习题 2 


static void Main(string[] args) 


{ 
for (int i = 1; i < 10000; i++) 
1 
WriteLine($"Loop cycle {i}"); 
if (i = 5000) 
{ 
WriteLine (args[999]); 
} 
} 
} 


f£ Visual Studio 中 ， 可 以 把 断 点 放 在 下 面 的 代码 行 上 : 


WriteLine ("Loop cycle {0}", i); 


应 修改 断 点 的 属性 ， 把 执行 次 数 的 条 件 设 置 为 “执行 次 数 等 于 5000 时 中 断 ”。 


Sek 3 
错误 ，finally 块 始终 会 执行 ， 它 可 能 在 处 理 catch 块 之 后 执行 。 


习题 4 


static void Main(string[] args) 
{ 
Orientation myDirection; 
for (byte myByte = 2; myByte < 10; myByte++) 
{ 
try 
{ 
myDirection = checked ( (Orientation) myByte) ; 
if ((myDirection < Orientation.North) | 
(myDirection > Orientation.West)) 
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{ 
throw new ArgumentoutofRangeException ("myByte", myByte, 
"Value must be between 1 and 4"); 
} 
} 
catch (ArgumentOutOfRangeException e) 
{ 
// If this section is reached then myByte < 1 or myByte > 4. 
WriteLine (e.Message) ; 
WriteLine ("Assigning default value, Orientation.North."); 
myDirection = Orientation.North; 
} 


WriteLine ($"myDirection = {myDirection}") ; 
} 
} 


注意 这 是 一 个 小 问题 。 因 为 枚 举 基于 byte 类 型 ， 所 以 可 为 其 赋予 任意 byte 值 ， 即 使 在 枚 举 中 没有 为 该 值 指 
定名 称 也 同样 如 此 。 在 上 面 的 代码 中 ， 如 有 必要 ， 可 以 生成 目 己 的 异种 。 


第 8 章 


习题 1 
b、d 和 e。public、private 和 protected 是 实际 的 可 访问 级 别 。 
习题 2 
错误 ， 永 远 都 不 应 手工 调用 对 象 的 析 构 函数 ，.NET 运行 库 环 境 会 在 垃圾 回收 过 程 中 自动 完成 该 任务 。 
习题 3 
不 ， 可 以 在 没有 任何 类 实例 的 情况 下 调用 静态 方法 。 
习题 4 


«Interface» 
ICup 


- Color 


- Volume 


+Refill() 
+Wash() 


+Drink() 

+AddMilk() 

+AddSugar 
A 


OQ ICup 


习题 5 


static void ManipulateDrink(HotDrink drink) 
{ 
drink.AddMilk(); 
drink.Drink(); 
ICup cupInterface = (ICup) drink; 
cupInterface.Wash(); 
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注意 显 式 转换 为 ICup 的 代码 行 。 这 是 必需 的 ， 因 为 HotDrink 不 支持 [Cup 接口 ， 但 我 们 知道 传送 给 这 个 函 
数 的 两 个 cup 对 象 支持 ICup 接口 。 这 很 危险 ， 因 为 也 可 以 给 这 个 函数 传递 其 他 类 ， 但 这 些 类 也 可 能 派生 于 
HotDrink， 而 HotDrink 却 不 支持 ICup 接口 。 为 更 正 这 个 问题 ， 应 检查 该 接口 是 否 得 到 支持 : 
static void ManipulateDrink (HotDrink drink) 
{ 
drink. AddMilk(); 
drink.Drink(); 
if (drink is ICup) 
{ 
ICup cupInterface = drink as ICup; 
cupInterface.Wash(); 
} 
} 


这 里 使 用 的 is 和 as 操作 符 将 在 第 11 章 介绍 。 
第 9 章 


习题 1 

myDerivedClass 派生 于 MyClass， 但 是 MyClass 是 密封 的 ， 不 能 从 MyClass 中 派生 其 他 类 。 
习题 2 

要 定义 不 可 创建 的 类 ， 可 以 将 其 定义 为 静态 类 ， 或 者 将 其 所 有 构造 函数 定义 为 私有 。 
习题 3 


不 可 创建 的 类 可 通过 它们 拥有 的 静态 成 员 来 使 用 。 实 际 上 ， 甚 至 可 以 通过 这 些 成 员 获 取 这 些 类 的 实例 ， 如 
下 所 示 : 


class CreateMe 


{ 
private CreateMe () 
{ 
} 
static public CreateMe GetCreateMe () 
{ 
return new CreateMe(); 
} 
} 


这 里 ， 公 共 构 造 函 数 可 以 访问 私有 构造 函数 ， 因 为 它 在 同一 个 类 的 定义 中 。 
习题 4 
为 简单 起 见 ， 下 面 的 类 定义 显示 为 一 个 代码 文件 的 一 部 分 ， 而 没有 给 每 个 类 定义 列 出 单独 的 代码 文件 : 


namespace Vehicles 

{ 
public abstract class Vehicle 
{ 


} 

public abstract class Car : Vehicle 

{ 

} 

public abstract class Train : Vehicle 
{ 

} 

public interface IPassengerCarrier 

{ 


public interface IHeavyLoadCarrier 
{ 
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} 

public class SUV : Car, IPassengerCarrier 

{ 

} 

public class Pickup : Car, IPassengerCarrier, IHeavyLoadCarrier 
{ 

} 

public class Compact : Car, IPassengerCarrier 

{ 

} 

public class PassengerTrain : Train, IPassengerCarrier 
{ 

} 

public class FreightTrain : Train, IHeavyLoadCarrier 

{ 

} 

public class T424DoubleBogey : Train, IHeavyLoadCarrier 
{ 

} 


习题 5 


using System; 

using static System.Console; 
using Vehicles; 

namespace Traffic 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
AddPassenger (new Compact()); 
AddPassenger (new SUV()); 
AddPassenger (new Pickup()); 
AddPassenger (new PassengerTrain()); 
ReadkKey () ; 
] 
static void AddPassenger(IPassengerCarrier Vehicle) 
{ 
WriteLine (Vehicle .ToString()); 
} 
} 
} 


第 10 X 


ea 1 


class MyClass 
{ 
protected string myString; 
public string ContainedsString 


{ 
sec 
{ 
myString = value; 
} 
} 
public virtual string GetString() => myString; 


2]g 2 


class MyDerivedClass : MyClass 
{ 
public override string GetString() => base.GetString() + 
" (output from derived class)"; 
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JA 3 
如 果 方 法 具有 人 返回 类 型 ， 束 可 以 将 其 用 作 表 达 式 的 一 部 分 : 


x = Manipulate (y, Z); 


WRIA ARDI AEREA, SE sz: EE V REA] TIEN ATA ERZ 33. EER 
中 ， 这 会 使 x 的 结果 变 得 模糊 ， 因 为 Manipulate0 方 法 没有 蔡 代 方法 。 如 果 没 有 这 个 方法 ， 可 能 只 需要 忽略 整 行 
代码 ， 但 编 详 堆 无 法 确定 我 们 是 售 的 确 布 望 忽略 它 。 

没有 返回 类 型 的 方法 不 能 作为 表达 式 的 一 部 分 来 调用 ， 所 以 编译 右 可 以 安全 地 删除 对 部 分 方法 调用 的 所 有 
引用 。 

同样 ， 也 茶 止 使 用 out 参数 ， 因 为 在 方法 调用 之 前 ， 用 作 out 参数 的 变量 必须 是 未 定义 的 ， 而 应 在 方法 调 
用 之 后 定义 。 删 除 方法 调用 会 违反 这 个 规则 。 


习题 4 


class MyCopyableclass 
{ 
protected int myInt; 
public int ContainedInt 
{ 
get 
{ 


return myInt; 


set 
{ 
myInt = value; 
} 
} 
public MyCopyableClass GetCopy() => (MyCopyableClass)MemberwiseClone(); 
} 
py Mur ls 
2e PF ig d: 
class Program 
{ 
using static System.Console; 
static void Main(string[] args) 
{ 
MyCopyableClass objl = new MyCopyableclass (); 
objl.ContainedInt = 5; 
MyCopyableClass obj2 = objl.GetCopy(); 
objl.ContainedInt = 9; 
WriteLine(obj2.ContainedInt); 
} 
} 


这 些 代 码 显 示 $， 说 明 所 复制 对 象 有 目 己 专用 的 myInt 字段 。 
ma 5 


using System; 
using static System.Console; 
using ChlOCardLib; 
namespace Exercise Answers 
{ 
class Classl 
{ 
static void Main(string[] args) 
{ 
while (true) 
{ 
Deck playDeck = new Deck(); 
playDeck.Shuffle(); 
bool isFlush - false; 
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int flushHandIndex = 0; 
for (int hand = 0; hand < 10; hand++) 


{ 
isFlush = true; 
suit flushSuit = playDeck.GetCard(hand * 5).suit; 
for (int card = 1; card < 5; card++) 
{ 
if (playDeck.GetCard(hand * 5 + card).suit !- flushsuit) 
{ 
isFlush = false; 
} 
} 
if (isFlush) 
{ 
flushHandIndex = hand * 5; 
break; 
) 
} 
if (isFlush) 
{ 
WriteLine("Flush!"); 
for (int card = 0; card «€ 5; card++) 
{ 
WriteLine (playDeck .GetCard (flushHandIndex + card)):; 
} 
} 
else 
{ 
WriteLine ("No flush."); 
} 


ReadLine (); 


} 
这 些 代码 会 循环 下 去 ， 因 为 同 花 色 是 不 常见 的 。 可 能 需要 按 几 次 Retum #2, 7 BETE HY Th ih PER Bl — 
个 同 花 色 。 为 了 验证 一 切 如 期 执行 ， 可 以 答 试 将 洗 牌 的 代 人 码 行 注释 掉 。 
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ea 1 


using System; 
using System.Collections; 
namespace Exercise Answers 


{ 
public class People : DictionaryBase 
{ 
public void Add(Person newPerson) => 
Dictionary.Add(newPerson.Name, newPerson); 
public void Remove(string name) -» Dictionary.Remove (name); 
public Person this[string name] 
i 
qet 
{ 
return (Person)Dictionary [name]; 
} 
set 
{ 
Dictionary[name] = value; 
} 
} 
} 


RA 2 


public class Person 


{ 


private string name; 
private int age; 
public string Name 
i 

get 

{ 


return name; 


set 
{ 
name = value; 
} 
} 
public int Age 
{ 
get 
{ 


return age; 


set 


{ 


} 
} 


age = value; 


public static bool operator >(Person pl, Person p2) 


pl.Age > p2.Age; 


public static bool operator <(Person pl, Person p2) 


pl.Age « p2.Age; 


public static bool operator »-(Person pl, Person p2) 


! (pl < p2); 


=> 


public static bool operator <=(Person pl, Person p2) => 


! (pl > p2); 


习题 3 


public Person[] GetOldest () 


{ 


Person oldestPerson null; 
People oldestPeople = new People(); 
Person currentPerson; 
foreach (DictionaryEntry p in Dictionary) 
{ 
currentPerson = p.Value as Person; 
if (oldestPerson == null) 
{ 
oldestPerson = currentPerson; 
oldestPeople.Add(oldestPerson); 
} 
else 
{ 
if (currentPerson > oldestPerson) 
{ 
oldestPeople.Clear(); 
oldestPeople.Add(currentPerson); 
oldestPerson - currentPerson; 
} 
else 
{ 
1f (currentPerson >= oldestPerson) 
{ 
oldestPeople.Add(currentPerson); 


] 


} 
} 


Person[] oldestPeopleArray = new Person[oldestPeople.Count]; 


int copyIndex = 0; 
foreach (DictionaryEntry p in oldestPeople) 
{ 
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oldestPeopleArray[copyIndex] = p.Value as Person; 
copyiIndex++; 


} 
return oldestPeopleArray; 


这 个 函数 比较 复杂 ， 因 为 没有 为 Person jg M12 AAT, (AVR et. Ah KIB) People 实例 更 加 
人 简单， 因为 在 处 理 过程 中 比较 容易 操作 这 个 类 。 作 为 一 个 折 中 方法 ， 在 整个 函数 中 都 使 用 了 People 实例 ， 再 在 
最 后 转换 为 一 个 Person 实例 数组 。 


>J 4 


public class People : DictionaryBase, ICloneable 


{ 
public object Clone () 
{ 
People clonedPeople = new People(); 
Person currentPerson, newPerson; 
foreach (DictionaryEntry p in Dictionary) 
i 
currentPerson = p.Value as Person; 
newPerson = new Person(); 
newPerson.Name = currentPerson.Name; 
newPerson.Age = currentPerson.Age; 
clonedPeople.Add(newPerson) ; 
} 
return clonedPeople; 
} 
} 


在 Person 类 上 实现 ICloneable 接口 ， 可 以 简化 这 段 代 人 三。 


JA 5 


public IEnumerable Ages 


{ 
get 
{ 
foreach (object person in Dictionary.Values) 
yield return (person as Person) .Age; 
} 
} 
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a、b 和 e 是 
c 和 4d 人 耕 ， 但 它们 可 以 使 用 由 包含 它们 的 类 提供 的 泛 型 类 型 参数 。 
ft. 


Jet 2 


public static double? operator * (Vector opl, Vector op2) 
{ 
try 


double angleDiff = (double) (op2.ThetaRadians.Value — 
opl.ThetaRadians.Value); 
return opl.R.Value * op2.R.Value * Math.Cos(angleDiff); 
} 


catch 


{ 


return null; 


JR 3 


不 在 T 上 强制 new0 约 束 ， 就 不 能 
用 的 。 


public class Instantiator<T> 
where T : new() 
{ 
public T instance; 
public Instantiator () 
{ 


} 


instance = new T(); 


习题 4 
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实例 化 T。 在 TT 上 强制 new0 约 束 可 确保 有 一 个 公共 的 默认 构造 函数 是 可 


同一 个 泛 型 类 型 参数 工 既 用 于 泛 型 类 ， 又 用 于 泛 型 方法 。 需 要 重 命名 其 中 的 一 个 或 两 个。 例如 : 


public class StringGetter<U> 
{ 


public string GetString<T>(T item) => item.ToString(); 


} 


习题 5 
一 种 方式 如 下 : 


public class ShortList<T> : IList<T> 


{ 


protected IList<T> innercollection; 


protected int maxSize = 10; 
public ShortList() 
: this(10) 


i 
} 
public ShortList (int size) 
i 
maxSize = size; 


innerCollection = new List<T>(); 


} 


public ShortList (IEnumerable<T> list) 


: this(10, list) 


i 
} 
public ShortList(int size, IEnumerable<T> list) 
i 
maxSize = size; 


innerCollection = new List<T> (list); 


if (Count > maxSize) 


{ 


ThrowTooManyItemsException(); 


} 
} 


protected void ThrowTooManyItemsException () 


{ 


throw new IndexOutOfRangeException( 


"Unable to add any more 
+ " 1tems5."); 
} 


#region IList<T> Members 


items, maximum size is " + maxSize.ToString() 


public int IndexOf(T item) => innerCollection.Indexof (item); 


public void Insert(int index, 


{ 


if (Count < maxSize) 


{ 


T item) 


innerCollection.Insert (index, item); 
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} 


else 


i 
ThrowTooManyItemsException(); 


} 


} 
public void RemoveAt (int index) 


{ 


innerCollection.RemoveAt (index); 
} 
public T this[int index] 


{ 
get 


{ 
} 
set 


{ 
} 


return innerCollection[index]; 


innerCollection[index] = value; 


} 
#endregion 
#region ICollection<T> Members 
public void Add(T item) 
{ 
if (Count < maxSize) 


{ 
} 


else 


{ 


innerCollection.Add (item); 


ThrowTooManyItemsException(); 
} 
} 
public void Clear () 
{ 


} 
public bool Contains(T item) => innerCollection.Contains (item); 
public void CopyTo(T[] array, int arrayIndex) 


{ 


innerCollection.Clear(); 


innerCollection.CopyTo (array, arrayIndex); 
} 
public int Count 


{ 
get 


{ 
} 


return innercollection.Count; 


} 
public bool IsReadOnly 


{ 
get 


{ 
} 


return innerCollection.IsReadOnly; 


} 

public bool Remove(T item) => innerCollection.Remove (item); 

#endregion 

#region IEnumerable<T> Members 

public IEnumerator<T> GetEnumerator() => 
innerCollection.GetEnumerator () : 

#endregion 

#region IEnumerable Members 

IEnumerator IEnumerable.GetEnumerator() => GetEnumerator(); 

#endregion 


习题 6 


不 。 类 型 参数 工 定 义 为 协 变 。 但 协 变 参数 类 型 只 能 用 作 方 法 的 返回 值 ， 不 能 用 作 方 法 实 参 。 盏 则 就 会 得 到 
如 下 编 详 错误 (假定 使 用 名 称 空间 VarianceDemo): 


Invalid variance: The type parameter 'T' must be contravariantly valid on 
'VarianceDemo. IMethaneProducer<T>.BelchAt(T)'. 'T' is covariant. 


AS 
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习题 1 


using static System.Console; 
public void ProcessEvent (object source, EventArgs e) 


{ 


习题 2 
修改 Playercs， 如 下 所 示 ( 修 改 了 一 个 方法 ， 添 加 了 两 个 新 方法 


if (e is MessageArrivedEventArgs) 


{ 


WriteLine("Connection.MessageArrived event received."); 
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WriteLine($"Message: [(e as MessageArrivedEventArgs).Message }"); 


] 
if (e is ElapsedEventArgs) 


{ 


WriteLine ("Timer.Elapsed event received."); 


WriteLine($"SignalTime: [(e as ElapsedEventArgs ).SignalTime }"); 


} 


public bool HasWon () 


{ 


// get temporary copy of hand, which may get modified. 


Cards tempHand = (Cards)PlayHand.Clone(); 
// find three and four of a kind sets 
bool fourOfAKind - false; 
bool threeOfAKind = false; 
int fourRank - -1; 
int threeRank = -1; 
int cardsOfRank; 
for (int matchRank = 0; matchRank < 13; matchRank++) 
{ 

cardsOfRank = 0; 

foreach (Card c in tempHand) 

{ 


if (c.rank == (Rank)matchRank) 
{ 
cardsOfRank++; 
} 
} 
1f (cardsOfRank == 4) 


{ 
// Mark set of four 
fourRank = matchRank; 
fourOfAKind if (cardsOfRank -- 3) 


// two threes means no win possible 

// (threeOfAKind will be true only if this code 
// has already executed) 

if (threeofAKind -- true) 

{ 


} 
// Mark set of three 


threeRank = matchRank; 
threeOfAKind = true; 


return false; 


} 
} 


// check simple win condition 
if (threeOfAKind && fourOfAKind) 


{ 
} 


return true; 


// simplify hand if three or four of a kind is found, 


// by removing used cards 
if (fourOfAKind || threeofAkind) 
{ 


for (int cardIndex = tempHand.Count - 1; cardIndex >= 0; 


{ 


代码 中 的 注释 说 明了 这 些 变化 ): 


CardIndex--) 
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if ((tempHand[cardIndex].rank == (Rank) fourRank) 
|| (tempHand[cardIndex].rank == (Rank) threeRank) ) 
{ 
tempHand.RemoveAt (cardIndex); 
} 
} 


// at this point the method may have returned, because: 
// — a set of four and a set of three has been found, winning. 
// — two sets of three have been found, losing. 
// if the method hasn't returned then: 
// - no sets have been found, and tempHand contains 7 cards. 
// a set of three has been found, and tempHand contains 4 cards. 
// — a set of four has been found, and tempHand contains 3 cards. 
// find run of four sets, start by looking for cards of same suit 
// in the same way as before 
bool fourOfASuit - false; 
bool threeOfASuit = false; 
int fourSuit = -1; 
int threesuit - -1; 
int cardsofsuit; 
for (int matchSuit = 0; matchSuit < 4; matchSuit++) 
{ 
cardsofsuit = 0; 
foreach (Card c in tempHand) 


{ 


if (c.suit == (Suit)matchsuit) 
{ 
cardsofsuit++; 
} 
} 
if (cardsOfSuit == 7) 


{ 


// if all cards are the same suit then two runs 
// are possible, but not definite. 
threeOfASuit = true; 
threeSuit = matchsuit; 
fourOfASuit - true; 
foursuit = matchsuit; 
} 
if (cardsofsuit == 4) 
{ 
// mark four card suit. 
fourOfASuit - true; 
fourSuit = matchSuit; 
} 
if (cardsofsuit == 3) 
{ 
// Mark three card suit. 
threeofASuit = true; 
threeSuit = matchSuit; 
} 
} 
if (!(threeofAsuit || fourofAsuit)) 
{ 
// need at least one run possibility to continue. 
return false; 
} 
if (tempHand.Count == 7) 


{ 
if (!(threeofASuit && fourOfASuit) ) 


// need a three and a four card suit. 
return false; 
} 
// create two temporary sets for checking. 
Cards setl = new Cards(); 
Cards set2 = new Cards(); 
// if all 7 cards are the same suit... 
if (threeSuit == foursuit) 
{ 
// get min and max cards 
int maxVal, minVal; 
GetLimits (tempHand, out maxVal, out minVal); 
for (int cardIndex = tempHand.Count - 1; cardIndex >= 0; cardIndex--) 
{ 
if (((int)tempHand[cardIndex].rank < (minVal + 3)) 
|| ((int)tempHand[cardIndex].rank > (maxVal - 3))) 


{ 
// remove all cards in a three card set that 
// starts at minVal or ends at maxVal. 
tempHand.RemoveAt (cardIndex); 
} 
} 
if (tempHand.Count != 1) 
{ 
// if more then one card is left then there aren't two runs. 
return false; 
} 
if ((tempHand[0].rank == (Rank) (minVal + 3)) 
|| (tempHand[0].rank == (Rank) (maxVal - 3))) 
{ 
// if spare card can make one of the three card sets into a 
// tour card set then there are two sets. 
return true; 
} 
else 
{ 
// if spare card doesn't fit then there are two sets of three 
// cards but no set of four cards. 
return false; 
} 
} 
// if three card and four card suits are different... 
foreach (Card card in tempHand) 
{ 
// split cards into sets. 
if (card.suit == (Suit) threeSuit) 
{ 
setl.Add(card); 
} 
else 
{ 
set2.Add(card); 
} 
} 
// check if sets are sequential. 
if (isSequential(setl) && isSequential (set2)) 
{ 
return true; 
} 
else 


{ 
} 


return false; 


} 

// 1£ four cards remain (three of a kind found) 

if (tempHand.Count == 4) 

{ 
// if four cards remain then they must be the same suit. 
if (!fourOfASuit) 
{ 


} 


// won if cards are sequential. 
if (isSequential (tempHand) ) 
{ 


return false; 


return true; 


} 


// 1£ three cards remain (four of a kind found) 
if (tempHand.Count == 3) 


// if three cards remain then they must be the same suit. 
if (!threeofASuit) 
{ 
return false; 
} 
// won if cards are sequential. 
if (isSequential (tempHand) ) 
{ 
return true; 
} 
} 
// return false if two valid sets don't exist. 
return false; 
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} 


// utility method to get max and min ranks of cards 
// (same suit assumed) 
private void GetLimits(Cards cards, out int maxVal, out int minVal) 


{ 
maxVal = 0; 
minVal = 14; 
foreach (Card card in cards) 
{ 
if ((int)card.rank > maxVal) 
{ 
maxVal = (int)card.rank; 
} 
if ((int)card.rank < minVal) 
minVal = (int)card.rank; 
] 
} 
} 


// utility method to see if cards are in a run 
// (same suit assumed) 
private bool isSequential(Cards cards) 
{ 
int maxVal, minVal; 
GetLimits (cards, out maxVal, out minVal); 


if ((maxVal - minVal) == (cards.Count - 1)) 
{ 
return true; 
} 
else 
{ 
return false; 
} 
} 
2]gà 3 


AER MEM AM sates, DAT —-TRUN CEMA. UAT, AMIR OA ER 
JESGA MS A. JJ, BAY EASE a PRG, 在 一 个 步骤 中 实例 化 和 初始 化 这 个 类 ; 


Giraffe myPetGiraffe = new Giraffe 


{ 
NeckLength = "3.14", 
Name — "Gerald" 
yF 
习题 4 


错误 。 在 使 用 var 关键 子 来 声明 变量 时 ， 该 变量 仍 是 强 类 型 化 的 ， 编 详 融 会 确定 变量 的 类 


习题 5 
可 以 使 用 已 实现 的 Equals0 方 法 。 注 意 不 能 使 用 一 运算 符 来 执行 这 个 操作 ， 因 为 一 运算 符 会 比较 变量 ， 来 
确定 它们 是 否 引 用 同一 个 对 象 。 
习题 6 
扩展 方法 必须 是 静态 的 : 
public static string ToAcronym(this string inputString) 
习题 7 


必须 在 静态 类 中 包 舍 扩展 方法 ， 可 在 包 舍 客 户 代 码 的 名 称 空间 中 访问 它 。 为 此 ， 可 以 在 同一 个 名 称 空间 中 
包含 代码 ， 或 者 导入 包含 该 类 的 名 称 空间 。 
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a 8 
一 种 方式 如 下 : 


public static string ToAcronym(this string inputString) => 
inputString.Trim().Split(' ').Aggregate<string, string>("", 
(a, b) => a + (b.Length > 0 ? 
b.ToUpper () [0].ToString() : "")); 


其 中 使 用 了 三 元 运算 符 以 防 多 个 空格 引发 错误 。 还 要 注意 需要 带 两 个 泛 型 类 型 参数 的 Ageregate0 版 本 ， 因 
为 需要 一 个 种 子 值 。 
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习题 1 


将 TextBlock 控件 包装 到 一 个 ScrollViewer 面板 中 。 把 VerticalScrollBarVisibility 属性 设 为 Auto Ja, “4A 
超出 了 控件 撒 边 时 ， 会 显示 滚动 栏 。 


«Window x:Class-"Answers.MainWindow" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 

Title-"14.1 Solution" Height-"350" Width="525"> 
«Grid» 
<Grid.RowDefinitions> 
<RowDefinition Height="75"/> 
<RowDefinition /> 
</Grid.RowDefinitions> 
«Label Content="Enter text" HorizontalAlignment-"Left" Margin="10,10,0,0" 
VerticalAlignment="Top"/> 
«TextBox HorizontalAlignment-"Left" Margin-"76,12,0,0" TextWrapping="Wrap" 
VerticalAlignment-"Top" Height-"53" Width="423" AcceptsReturn-"True" 
Name="textTextBox"> 
</TextBox> 
<ScrollViewer HorizontalAlignment-"Left" Height-"217" Margin="10,10,0,0" 

Grid.Row="1" VerticalAlignment="Top" Width="489" 

VerticalScrollBarVisibility-"Auto"- 

«TextBlock TextWrapping-"Wrap" Text="{Binding ElementName=textTextBox, 

Path=Text } "/> 

</ScrollViewer> 
</Grid> 
</Window> 


习题 2 


将 一 个 Slider 和 一 个 ProgressBar 控 件 拖 动 到 视图 中 后 ,将 Slider 控 件 的 最 小 值 和 最 大 值 分 别 设置 为 1 和 100， 
将 其 Value 属性 设 为 1。 把 ProgressBar 的 相同 值 绑 定 到 Slider 上 。 


«Window x:Class="Answers. Chl4Solution2" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
Title-"14.2 Solution" Height-"300" Width="300"> 

«Grid» 
«Slider HorizontalAlignment-"Left" Margin-"10,10,0,0" VerticalAlignment-"Top" 

Width-"264" Minimum-"1" Maximum-"100" Name="valueSlider"/> 

<ProgressBar HorizontalAlignment-"Left" Height-"24" Margin-"10,77,0,0" 

VerticalAlignment-"Top" Width-"264" 

Minimum="{Binding ElementName-valueSlider, Path=Minimum}" 

Maximum="{Binding ElementName=valueSlider, Path=Maximum}" 

Value="{Binding ElementName=valueSlider, Path=Value}"/> 

</Grid> 
</Window> 
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JA 3 


可 使 用 RenderTransform。 在 设计 视图 中 ， 可 将 光标 移 到 控件 边缘 处 ， 看 到 一 个 四 回 节 头 
控件 将 其 拖 动 到 目标 位 置 。 


«Window x:Class-"Answers. Chl4Solution3" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 

Title-"14.3 Solution" Height-"300" Width="300"> 
«Grid» 
«Slider HorizontalAlignment-"Left" Margin-"10,10,0,0" VerticalAlignment-"Top" 

Width-"264" Minimum-"1" Maximum-"100" Name="valueSlider"/> 

«ProgressBar HorizontalAlignment-"Left" Height-"24" Margin-"-17,125,-10,0" 

VerticalAlignment-"Top" Width="311" 

Minimum="{Binding ElementName-valueSlider, Path-Minimum]" Maximum-" [Binding 

ElementName-valueSlider, Path-Maximum]" 
Value="{Binding ElementName-valueSlider, Path=Value}" 
RenderTransformOrigin-"0.5,0.5"- 
<ProgressBar.RenderTransform> 
<TransformGroup> 
<ScaleTransform/> 
<SkewTransform/> 
<RotateTransform Angle="-36.973"/> 
<TranslateTransform/> 
</TransformGroup> 
</ProgressBar.RenderTransform> 
</ProgressBar> 
</Grid> 
</Window> 


图 标 后 ， 可 以 单 击 


习题 4 


PersistentSlider 类 必须 实现 INotifyPropertyChanged 接口 。 


创建 一 个 字段 ， 用 于 保存 3 个 属性 的 值 。 


在 属性 的 每 个 setter 中 ， 调 用 PropertyChanged 事件 的 任意 订阅 者 。 为 达到 此 目的 ， 创 建 一 个 辅助 方法 ， 命 
名 为 OnPropertyChanged. 


PersistentSlider.cs 
using System.ComponentModel; 
namespace Answers 
{ 
public class PersistentSlider : INotifyPropertyChanged 
{ 
private int minValue; 
private int maxValue; 
private int  currentValue; 
public int MinValue 
{ 
get { return minValue; } 
set { minValue = value; OnPropertyChanged (nameof (MinValue)); } 
} 
public int MaxValue 
{ 
get [ return maxValue; } 
set { maxValue = value; OnPropertyChanged (nameof (MaxValue)); ] 
} 
public int CurrentValue 
{ 
get { return currentValue; } 
set { _currentValue = value; OnPropertyChanged (nameof (CurrentValue)); } 
} 
public event PropertyChangedEventHandler PropertyChanged; 
protected void OnPropertyChanged (string propertyName) => 
PropertyChanged?.Invoke (this, new PropertyChangedEventArgs (propertyName) ); 
] 
} 


(1) 在 代码 隐 兰 文件 中 ， 添 加 如 下 字段 : 


private PersistentSlider  sliderData = new PersistentSlider { MinValue = 1, 
MaxValue = 200, CurrentValue = 100 }; 
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(2) 在 构造 函数 中 ， 将 当前 实例 的 DataContext 属性 设置 为 刚才 创建 的 字段 : 


this.DataContext =  sliderData; 
InitializeComponent (); 


(3) f£ XAML 中 ， 将 Slider 控件 修改 为 使 用 数据 上 下 文 。 只 需要 设置 Path: 


«Window x:Class-"Answers. Chl4Solution4" 
xmlns-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
Title-"14.4 Solution" Height-"300" Width="300"> 

«Grid» 
«Slider HorizontalAlignment-"Left" Margin-"10,10,0,0" VerticalAlignment-"Top" 

Width-"264" Minimum="{Binding Path=MinValue}" 

Maximum="{Binding Path=MaxValue}" Value="{Binding Path=CurrentValue}" 

Name="valueSlider"/> 

«ProgressBar HorizontalAlignment-"Left" Height="24" Margin-"-17,125,-10,0" 

VerticalAlignment-"Top" Width="311" 

Minimum-"[Binding ElementName-valueSlider, Path=Minimum}" 

Maximum="{Binding ElementName-valueSlider, Path=Maximum}" 

Value="{Binding ElementName=valueSlider, Path=Value}" 

RenderTransformorigin="0.5,0.5"> 

«ProgressBar.RenderTransform- 
<TransformGroup> 
<ScaleTransform/> 
«SkewTransform/-» 
«RotateTransform Angle-"-36.973"/- 
«TranslateTransform/- 
</TransformGroup> 
«/ProgressBar.RenderTransform- 
</ProgressBar> 
</Grid> 
</Window> 
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习题 1 


解决 方案 : 
(1) 创建 一 个 新 类 ， 其 名 称 为 ComputerSkillValueConverter， 如 下 所 示 : 


using Chl3CardLib; 
using System; 
using System.Windows.Data; 


namespace KarliCards Gui 
{ 
[ValueConversion (typeof (ComputerSkillLevel), typeof (bool) ) ] 
public class ComputerSkillValueConverter : IValueConverter 
{ 
public object Convert (object value, Type targetType, object parameter, 
System.Globalization.CultureInfo culture) 
{ 
string helper = parameter as string; 
if (string.IsNullOrWhiteSpace (helper) ) 
return false; 


ComputerSkillLevel skillLevel = (ComputerSkillLevel) value; 
return (skillLevel.ToString() == helper); 
} 


public object ConvertBack (object value, Type targetType, object parameter, 
System.Globalization.CultureInfo culture) 


{ 
string parameterString = parameter as string; 
if (parameterString == null) 
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return ComputerSkillLevel.Dumb; 


return Enum.Parse(targetType, parameterString); 


} 


} 
(2) 在 Options.xaml 中 添加 一 个 静态 资源 声明 : 


<Window.Resources> 
«src:ComputerSkillValueConverter x:Key-"skillConverter" /> 
</Window. Resources> 


(3) 修改 单 选 按钮 ， 如 下 所 示 : 


<RadioButton Content="Dumb" HorizontalAlignment="Left" 
Margin="37,41,0,0" VerticalAlignment-"Top" Name-"dumbAIRadioButton" 
IsChecked="{Binding ComputerSkill, Converter={StaticResource skillConverter}, 
ConverterParameter=Dumb}" /> 

«RadioButton Content-"Good" HorizontalAlignment="Left" 
Margin-"37,62,0,0" VerticalAlignment-"Top" Name-"goodAIRadioButton" 
IsChecked="{Binding ComputerSkill, Converter={StaticResource skillConverter}, 
ConverterParameter=Good}" /> 

<RadioButton Content-"Cheats" HorizontalAlignment="Left" 
Margin="37,83,0,0" VerticalAlignment-"Top" Name-"cheatingAIRadioButton" 
IsChecked="{Binding ComputerSkill, Converter={StaticResource skillConverter}, 
ConverterParameter=Cheats}" /> 


(4) 删除 代码 隐藏 文件 中 的 事件 。 
JA 2 


解决 方案 ; 
(1) 在 Options.xaml 对 话 框 中 添加 一 个 新 的 复 选 框 ; 


<CheckBox Content="Plays with open cards" HorizontalAlignment="Left" 
Margin-"10,100, 0,0" VerticalAlignment-"Top" 
IsChecked=" {Binding ComputerPlaysWithOpenHand]" /> 


(2) 在 GameOptions.cs 类 中 添加 一 个 新 属性 : 


private bool computerPlaysWithOpenHand; 
public bool ComputerPlaysWithOpenHand 
{ 
get { return computerPlaysWithOpenHand; } 
set 
{ E 
 computerPlaysWithOpenHand = value; 
OnPropertyChanged (nameof (ComputerPlaysWithOpenHand) ); 
] 
} 


(3) 在 CardsInHandControl 中 添加 一 个 新 的 依赖 属性 : 


public bool ComputerPlaysWithOpenHand 

{ 
get { return (bool) GetValue (ComputerPlaysWithOpenHandProperty); |] 
set { SetValue (ComputerPlaysWithOpenHandProperty, value); } 

} 


public static readonly DependencyProperty ComputerPlaysWithOpenHandProperty = 
DependencyProperty.Register ("ComputerPlaysWithOpenHand", typeof (bool), 
typeof (CardsInHandcControl), new PropertyMetadata(false)); 


(4) 在 CardsInHandControl 类 的 DrawCards 方法 中 ， 修 改 对 isFaceUP 所 做 的 测试 : 


if (Owner is ComputerPlayer) 
isFaceup = (Owner.State == CardLib.PlayerState.Loser || 
Owner.State == CardLib.PlayerState.Winner || ComputerPlaysWithOpenHand); 


(5) 给 GameViewModel 添加 一 个 新 属性 : 


public bool ComputerPlaysWithOpenHand 
{ 
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get { return gameoptions.ComputerPlaysWithOpenHand; } 
(6) 将 新 属性 绑 定 到 所 有 4 T bU Ux mh] CardsInHandControls: 
ComputerPlaysWithoOpenHand="{Binding GameOptions.ComputerPlaysWithOpenHand]" 
习题 3 


解决 方案 
(1) 在 GameViewModel 中 添加 一 个 新 属性 ， 如 下 所 示 : 


private string currentStatusText = "Game is not started"; 
public string CurrentStatusText 
{ 


get { return currentStatusText; } 

set 

{ 
 currentStatusText = value; 
OnPropertyChanged (nameof (CurrentStatusText)); 


} 
} 


(2) 修改 CurrentPlayer 属性 ， 如 下 所 示 : 


public Player CurrentPlayer 
{ 


get { return currentPlayer; } 

set 

{ 
 currentPlayer = value; 
OnPropertyChanged ("CurrentPlayer"); 


if (!Players.Any(x => x.State == PlayerState.Winner) ) 


{ 
Players.ForEach(x => x.State = (x == value ? PlayerState.Active : 
PlayerState.Inactive) ) 


CurrentStatusText = $"Player {CurrentPlayer.PlayerName} ready"; 


} 
else 
{ 
var winner = Players.Where(x => x.HasWon).FirstOrDefault (); 
if (winner != null) 
CurrentStatusText = $"Player {winner.PlayerName} has WON!"; 
} 


} 
} 


(3) 在 StartNewGame 方法 的 末尾 处 添加 下 面 的 代码 : 
CurrentStatusText = string.Format ("New game stated. Player {0} to start", 
CurrentPlayer.PlayerName) ; 


(4) FERRE P mE] XAML 中 添加 一 个 状态 栏 ， 将 其 绑 定 到 新 属性 : 


<StatusBar Grid.Row-"3" HorizontalAlignment-"Center" Margin="0,0,0,15" 
VerticalAlignment-"Center" Background-"Green" Foreground-"White" FontWeight="Bold"> 
<StatusBarItem VerticalAlignment="Center"> 
<TextBlock Text="{Binding CurrentStatusText}" /> 


«/StatusBarItem- 
</StatusBar> 


第 16 章 


习题 1 

为 回答 这 个 问题 ， 应 看 看 Game.cs 文件 中 的 PlayGameO0 方 法 。 查 看 该 方法 ， 列 出 它 在 主 循环 do..while 中 
引用 的 变量 。 这 些 信息 需要 在 客户 问 和 服务 占 之 间 来 回 传送 ， 使 游戏 能 通过 Web 站 点 工作 : 

e 多 少 人 在 玩 游戏 ? 他 们 的 名 字 是 什么 ? 
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e 当前 的 玩家 是 谁 ? 

e 玩家 的 牌 

e 下 在 处 理 的 有 牌 

e ZHE, Puth, BERF 
e 被 弃 的 牌 列 表 

e 游戏 的 状态 ， 例 如 是 否 有 人 获胜 


eA 2 


可 将 信息 存储 在 数据 库 中 ， 再 检索 每 个 调用 所 需 的 数据 ， 使 用 ASPNET Session Object 或 VIEWSTATE 可 
在 客户 疹 和 服务 器 之 间 来 回 传递 所 需 的 信息 。 

关于 ASPNET Session Object 的 信息 ， 可 以 阅读 这 篇 文章 : 

https://msdn.microsoft.com/en-us/library/ms 17858 1 .aspx 

XT VIEWSTATE 的 信息 ， 可 以 阅读 这 篇 文章 : 

https://msdn.microsoft.com/en-us/library/ms972976.aspx 
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>i 1 


using System.Net; 
using System.IO; 
using Newtonsoft.Json; 
using static System.Console; 
namespace handofcards 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
List<string> cards = new List<string>(); 
var playerName = "Benjamin"; 
string GetURL = 
"http: //handofcards.azurewebsites.net/api/HandofCards/" + 
playerName; 
WebClient client = new WebClient(); 
Stream dataStream = client.OpenRead (GetURL); 
StreamReader reader = new StreamReader (datastream); 
Var results = 
JsonConvert.DeserializeObject«dynamic» (reader.ReadLine!()); 
reader.Close(); 
foreach (var item in results) 


WriteLine((string)item.imageLink); 


] 
ReadLine(t); 


ea 2 


Web App VM 的 最 大 大 小 是 4CPU / 核 (~ 2.6 Ghz)fll 7GB 的 RAM. 

标准 模式 下 拥有 的 VM 最 大 数量 是 10。 高 级 模式 下 拥有 的 VM 最 大 数量 是 50。 这 会 转化 为 最 大 200X2.6 Ghz 
核 ， 在 50 个 虚拟 机 上 加 载 350 GB 的 内 存 。 

注意 ， 这 用 于 Web 应 用 程序 。 可 利用 Azure VM 或 Azure 云 服 务 获得 更 多 内 核 和 内 存 。 
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第 20 章 


习题 1 
习题 2 

需要 随机 访问 文件 时 ， 或 者 不 处 理 字符 串 数据 时 ， 可 使 用 FileStream 对 象 写 入 文件 。 
习题 3 


Peek): 获取 文件 中 下 一 个 字符 的 值 ， 但 不 前 移 到 下 一 个 文件 位 置 

Read0: 获取 文件 中 下 一 个 字符 的 值 ， 并 前 移 到 下 一 个 文件 位 置 

Read(char[] buffer, int index, int count): 从 buffer[index] 开 始 ， 把 count 4 E PELA buffer 
ReadLine(): 获取 一 行文 本 

ReadToEnd(): 获取 文件 中 的 所 有 文本 


2] 4 
DeflateStream 
习题 5 


e Changed: 修改 文件 时 发 生 

e Created: 创建 文件 时 发 生 

e Deleted: 删除 文件 时 发 生 

e Renamed: 重 命 名 文件 时 发 生 
38i 6 


添加 一 个 按钮 ， 切 换 FileSystemWatcher.EnableRaisingEvents 属性 的 值 。 
第 21 章 


习题 1 


(1) 双击 Create Node 按钮 ， 让 事件 处 理 程序 执行 操作 。 
(2) 在 创建 XmlComment 后 ， 插 入 如 下 3 行 代码 : 


xmlAttribute newPages = document.CreateAttribute ("pages"); 
newPages.Value = "1000"; 
newBook.Attributes.Append (newPages) ; 


习题 2 


(1) //elements 一 一 返回 文档 中 的 所 有 市 点 。 
(2) element 一 一 返回 文档 中 的 每 个 元 率 节 后， 但 不 返回 元 率 根 节 反 。 
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(3) element[@Type=Noble Gas'] 一 一 返回 其 Type 特性 的 值 是 Noble Gas 的 每 个 元 系 。 

(4) //mass 一 一 返回 名 为 mass 的 所 有 节点 。 

(5) //mass/.. 一 一 使 XPath 从 选中 的 节点 向 上 移动 一 个 位 置 ， 这 意味 着 这 个 查询 会 选择 包含 mass 节点 的 所 有 
TR 

(6) element/specification[mass='20.1797'] 一 一 选择 包含 mass i {BA 20.1797 的 specification 75 &- 

(7) element/name[text()7'Neon'] 一 一 要 选择 包含 测试 内 容 的 节点 ， 可 使 用 textQER ZI ESE AY Neon 
的 name 节点 。 


Jet 3 


XML 可 以 是 有 效 的 、 格 式 恨 好 的 ， 也 可 以 是 无 效 的 。 选 择 XML 文档 的 一 部 分 时 ， 只 是 得 到 整个 XML x 
档 的 一 个 片段 。 这 意味 看 ， 所 选择 的 XML 在 单独 使 用 时 很 可 能 是 无 效 的。 大 多 数 XML AA a dB Ak AN A 
不 正确 的 XML， 所 以 不 能 在 标准 XML 查看 器 中 直接 显示 许多 查询 的 结果 。 


习题 4 
在 MainWindow.xaml 中 添加 一 个 新 按钮 ISON > XML， 然 后 给 MainWindow.xaml.cs 添加 以 下 代码 : 


private void buttonConvertXMLtoJSON Click(object sender, RoutedEventArgs e) 
{ 

// Load the XML document. 

xmlDocument document = new XmlDocument (); 


document .Load (@"C:\BeginningCSharp7\Chapter21\XML and Schemas\ 
Books.xml"); 


string json = Newtonsoft.Json.JsonConvert.SerializeXxmlNode (document) ; 
textBlockResults.Text = json; 


System.IO.File.AppendAllText 
(@"C: \BeginningCSharp7\Chapter21\XML and Schemas\Books 
.Json", 
json) ; 
} 
private void buttonConvertJSONtoXML Click(object sender, RoutedEventArgs e) 
1 
// Load the json document. 
string json - System.IO.File.ReadAllText 
(@"c: \BeginningCSharp7\Chapter21\XML and Schemas\Books. json") ; 


XmlDocument document = 
Newtonsoft.Json.JsonConvert.DeserializexmlNode (json) ; 


textBlockResults.Text = 
FormatText (document.DocumentElement as XmlNode, "", ""); 
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习题 1 


static void Main(string[] args) 
{ 

string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", 
"Small", "Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", “Fatimah" }; 


var queryResults = 
from n in names 
where n.StartsWith("S") 
orderby n descending 
select n; 
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Console.WriteLine ("Names beginning with S:"); 


foreach (var item in queryResults) { 
Console.WriteLine (item); 


} 


Console.Write("Program finished, press Enter/Return to continue:"); 
Console.ReadLine (); 


习题 2 
在 小 于 5 000 000 的 集中 ， 没 有 小 于 1000 的 数字 : 


static void Main(string[] args) 
{ 
int[] arraySizes = { 100, 1000, 10000, 100000, 
1000000, 5000000, 10000000, 50000000 }; 


foreach (int i in arraySizes) { 
int[] numbers = generateLotsOfNumbers (1); 
var queryResults = from n in numbers 
where n < 1000 
select n; 
Console.WriteLine("number array size = {0}: Count(n « 1000) = {1}", 
numbers.Length, queryResults.Count () 
); 
} 


Console.Write ("Program finished, press Enter/Return to continue:"); 
Console.ReadLine (); 


JA 3 
对 于 n<1000， 性 能 受到 的 影响 并 不 明显 。 


static void Main(string[] args) 


{ 
int[] numbers = generateLotsOfNumbers (12345678); 


Var queryResults = 
from n in numbers 
where n < 1000 
orderby n 
select n 


L| 
F 


Console.WriteLine("Numbers less than 1000:"); 
foreach (var item in queryResults) 


{ 
} 


Console.WriteLine (item); 


Console.Write ("Program finished, press Enter/Return to continue:"); 
Console.ReadLine(); 


Sm 4 
对 于 非常 大 的 子 集 ， 例 如 n= 1000, mi^ n< 1000， 会 非常 慢 : 


static void Main(string[] args) 


{ 


int[] numbers = generateLotsOfNumbers (12345678); 


Var queryResults = 
from n in numbers 
where n > 1000 
select n 
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= 
F 


Console.WriteLine("Numbers less than 1000:"); 
foreach (var item in queryResults) 


{ 
} 


Console.WriteLine (item); 


Console.Write("Program finished, press Enter/Return to continue:"); 
Console.ReadLine (); 


ea 5 
会 输出 所 有 名 字 ， 因 为 没有 碍 询 。 


static void Main(string[] args) 


| 
string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", 
"Small", "Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 


Var queryResults = names; 


foreach (var item in queryResults) { 
Console.WriteLine (item); 


} 


Console.Write("Program finished, press Enter/Return to continue:"); 
Console.ReadLine(); 


Static void Main(string[] args) 


{ 
string[] names = { "Alonso", "Zheng", "Smith", "Jones", "Smythe", 
"Small", "Ruiz", "Hsieh", "Jorgenson", "Ilyich", "Singh", "Samba", "Fatimah" }; 
// only Min() and Max() are available (if no lambda is used) 
// for a result set like this consisting only of strings 
Console.WriteLine("Min(names) = " + names.Min()); 
Console.WriteLine ("Max (names) = " + names.Max()); 
var queryResults = 

from n in names 

where n.Startswith("S") 

select n; 


Console.WriteLine ("Query result: names starting with 5"); 
foreach (var item in queryResults) 


{ 
} 


Console.WriteLine (item); 


Console .WriteLine ("Min (queryResults) = " + queryResults.Min()) 
Console.WriteLine ("Max (queryResults) = " + queryResults.Max()) 


Console.Write("Program finished, press Enter/Return to continue:"); 


Console.ReadLine(): 


} 


第 23 章 


习题 1 
注释 挥 两 本 书 的 显 式 创建 代码 ， 蔡 换 为 提示 输入 一 个 新 的 书 名 和 作者 的 代码 ， 如 下 : 


//Book book = new Book { Title = "Beginning C4 7", 
/ / Author = "Perkins, Reid, and Hammer" }; 
//db.Books.Add (book); 
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//book = new Book { Title = "Beginning XML", Author = "Fawcett, Quin, and Ayers"); 


string title; 
string author; 
Book book; 


do 
{ 


Console.Write("Title: "); title = Console.ReadLine(); 
Console.Write("Author: "); author = Console.ReadLine(); 


if (!string.IsNullOrEmpty (author) ) 
{ 
book = new Book { Title = title, Author = author }; 


db.Books.Add (book); 


db.SaveChanges (); 
} 
} while (!string.IsNullOrEmpty (author) ); 


习题 2 


添加 一 个 测试 LINQ 但 询 ， 在 添加 到 数据 库 之 前 ， 看 看 是 任 存 在 书 名 和 作者 相同 的 书 。 使 用 下 面 这 样 的 
代码 : 
Book book = new Book { Title = "Beginning C# 7", 


Author = "Perkins, Reid, and Hammer" }; 


var testQuery = from b in db.Books 
where b.Title == book.Title && b.Author == book.Author 
select b; 


if (testQuery.Count() < 1) 
{ 
db.Books.Add (book); 
db.SaveChanges (); 


} 


习题 3 


修改 生成 的 类 Stock.es. Store.cs 和 BookContext.cs， 以 使 用 Inventory 和 Item PR, 然后 在 Program.cs 中 修 


public partial class Stock 


{ 
public virtual Store Store { get; set; } 
} 
public partial class Store 
{ 


public Store () 
{ 


} 


Inventory = new HashSet<Stock>(); 


public virtual ICollection<Stock> Inventory { get; set; } 
} 


public partial class BookContext : DbContext 
{ 


protected override void OnModelCreating (DbModelBuilder modelBuilder) 
{ 
modelBuilder.Entity«Book»() 
.HasMany(e => e.Inventory) 
-WithOptional (e => e.Item) 
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.HasForeignKey(e => e.Item Code); 


modelBuilder.Entity<Store> () 
.HasMany(e => e.Inventory) 
.WithoOptional(e => e.Store) 
.HasForeignKey(e => e.Store StoreId); 


} 


class Program 
{ 
static void Main(string[] args) 
{ 
using (var db = new BookcContext()) 
{ 
var query = from store in db.Stores 
orderby store.Name 
select store; 
foreach (var s in query) 
{ 
XElement storeElement = new XElement("store", 
new XAttribute("name", s.Name), 
new XAttribute("address", s.Address), 
from stock in s.Inventory 
select new XElement("stock", 
new XALttribute("StockID", stock.StockId), 
new XAttribute("onHand", 
stock.onHand), 
new XAttribute("onOrder", 
stock.OnOrder), 
new XElement ("book", 
new XAttribute("title", 
stock.Item.Title), 
new XAttribute("author", 
stock. Item.Author) 
)// end book 
) // end stock 
); // end store 
Console.WriteLine(storeElement); 


习题 4 
使 用 如 下 代码 : 


using System; 

using System.Collections.Generic; 

using System.Ling; 

using System.Text; 

using System. Threading.Tasks; 

using System.Data.Entity; 

using System.ComponentModel.DataAnnotations; 


namespace BeginningCSharp7 23 Exercise4 GhostStories 
{ 
public class Story 
{ 
[Key] 
public int StoryID { get; set; } 
public string Title { get; set; } 
public Author Author { get; set; } 
public string Rating { get; set; } 
} 


public class Author 
{ 
[Key] 
public int AuthorId { get; set; } 
public string Name { get; set; } 
public string Nationality { get; set; } 
} 


public class StoryContext : DbContext 

{ 
public DbSet<Author> Authors { get; set; } 
public DbSet<Story> Stories { get; set; } 


void Main(string[] args) 


using (var db = new StoryContext ()) 


Author authorl = new Author 


{ 
Name = "Henry James", 
Nationality = "American" 

};? 

Story storyl = new Story 

i 
Title - "The Turn of the Screw", 
Author = authorl, 
Rating = "a bit dull" 

H 


db.Stories.Add(storyl); 


db.SaveChanges (); 


var query = from story in db.Stories 
orderby story.Title 
select story; 


Console.WriteLine ("Ghost Stories:"); 
Console.WriteLine (); 
foreach (var story in query) 
i 
Console.WriteLine(story.Title); 
Console.WriteLine(); 


} 


Console.WriteLine ("Press a key to exit... 


Console.ReadKey (); 


} 
class Program 
{ 
static 
{ 
i 
} 
} 
} 


第 24 章 


习题 1 


上 述 应 用 程序 都 可 以 。 


习题 2 


实现 数据 协定 ， 需 要 DataContractAttribute 和 DataMemberAttribute 特性 。 


2]g 3 
使 用 .sve 扩展 。 


习题 4 
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这 是 一 种 方式 ,但 把 所 有 WCF 配置 放 在 一 个 独立 配置 文件 中 通常 很 便 单 ,例如 web.config 或 app.config 中 。 


习题 5 


[ServiceContract] 
public interface IMusicPlayer 


{ 


[OperationContract (IsOneWay=true) ] 
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void Play(); 

[OperationContract (IsOneWay=true) ] 

void Stop(); 

[OperationContract] 

TrackInformation GetCurrentTrackInformation (); 


} 
XE v 2 — POUR ERA SR a, FETS PE TrackInformation. 
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J 1 


(1) 修改 BlankPagel HHI XAML, WF: 


<Page 
x:Class-"BasicNavigation.BlankPagel" 
xmlins-"http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
xmlns:x-"http://schemas.microsoft.com/winfx/2006/xaml" 
xmlins:local-"using:BasicNavigation" 
xmlins:d-"http://schemas.microsoft.com/expression/blend/2008" 
xmlns:mc-"http://schemas.openxmlformats.org/markup-compatibility/2006" 
mc:Ignorable-"d" Loaded-"Page Loaded"- 


«Grid Background-"[ThemeResource ApplicationPageBackgroundThemeBrush } "> 
<CommandBar> 
«AppBarToggleButton x:Name-"toggleButtonBold" Icon-"Bold" Label-"Bold" 
Click-"AppBarToggleButtonBold Click" /> 
«AppBarSeparator /> i 
«AppBarButton Icon-"Back" Label-"Back" Click-"buttonGoBack Click"/> 
«AppBarButton Icon-"Forward" Label-"Forward" 
Click-"AppBarButtonForward Click"/> 


<CommandBar. SecondaryCommands> 
<AppBarButton Icon-"Camera" Label="Take picture" /> 
«AppBarButton Icon-"Help" Label-"Help" /> 
«/CommandBar.SecondaryCommands- 
< /CommandBar> 


«TextBlock x:Name-"textBlockCaption" Text-"Page 1" 
HorizontalAlignment-"Center" Margin-"10,50,10,10" VerticalAlignment="Top"/> 
«StackPanel Orientation-"Horizontal" Grid.Row="1" 
HorizontalAlignment-"Center" VerticalAlignment="Bottom"> 
«Button Content-"Page 2" Click-"buttonGoto2 Click" /» 
«Button Content-"Page 3" Click-"buttonGoto3 Click" /> 
«Button Content-"Back" Click-"buttonGoBack Click" /> 
</StackPanel> 
<WebView x:Name-"webViewControl" 
HorizontalAlignment="Stretch" Margin="0,75,0,40" VerticalAlignment="Stretch" /> 
</Grid> 


</Page> 
(2) 进入 代码 隐藏 代码 ， 给 构造 函数 添加 如 下 代码 行 : 


webViewControl.Navigate (new Uri ("http://Www.Wrox.com")); 
Application.Current.Resuming += (sender, o) => webViewControl.Navigate (new 
Uri ("https://www.amazon.com/s/ref=nb sb noss 2?url= 
search-alias$3Dstripbookséfield-keywords=Beginning+C$23+7+Programming+ 
with+Visual+Studio+2017")); 
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在 Capabilities 选项 卡 上 指定 应 用 程序 有 哪些 功能 (在 Package.appxmanifest 文件 中 )。 73 Jf W 5877 In] Ae và XU] 
出 现 UnauthorizedAccessException, 4 tr tz bt KLIN TBE. 


